A GTK+ / GStreamer based music player
Anna 1940a31a77 Ocarina 6.5.7 1 month ago
core core/audio: Add a function to load tracks by filepath 5 months ago
gui gui/sidebar: Conditionally hide the rename menu option 2 months ago
include gui/sidebar: Add a right click menu 2 months ago
share gui/sidebar: Conditionally hide the rename menu option 2 months ago
tests gui/sidebar: Add a function for finding the current playlist 2 months ago
.gitattributes Ocarina 6.3 3 years ago
.gitignore tests: Build version test with CTest 1 year ago
.gitlab-ci.yml tests: Add a switch for disabling GUI tests 1 year ago
CHANGELOG core/playlists/system: Don't read 6.4.x playlists in new idle tasks 1 year ago
CMakeLists.txt Ocarina 6.5.7 1 month ago
CTestCustom.cmake tests: Build file test with ctest 1 year ago
LICENSE Update the license 3 years ago
PKGBUILD Ocarina 6.5.7 1 month ago
README.md Replace README with README.md 1 year ago
TODO gui/ocarina: Add basic command line options 1 year ago
ocarina.supp Add a valgrind suppression file 1 year ago


Ocarina 6.5

Ocarina is a simple GTK+ and GStreamer based music player written to let you listen to your music without getting in the way.


Ocarina is tracked with Git, and can be cloned from the following sources:

  • http://git.nowheycreamery.com/anna/ocarina.git
  • git://git.nowheycreamery.com/anna/ocarina.git
  • [master]
    • The most recent release. This branch does not change frequently.
  • [next]
    • Changes that will be included in the next release. This branch is for testing and bugfixing.


Ocarina uses cmaketo control the build process. After cloning the code, run cmake . to generate the Makefile. Compile using make

CMake Options

Ocarina supports the following options, which can be passed to cmake through cmake -D<option>=<ON|OFF>. For example, cmake -DCONFIG_DEBUG=ON would enable debugging.

    • Compile with debugging symbols enabled
    • Enable extra output when running unit tests
    • Enable running GUI unit tests
    • Enable unit tests that fetch album artwork


Once compiled, Ocarina can be run by invoking bin/ocarina on the command line.

Runtime options

The following options can be passed to Ocarina during startup

  • -h, --help
    • Print help message and exit
  • -n, --next
    • Tell a running Ocarina instance to play the next track
  • - P, --pause
    • Tell a running Ocarina instance to pause playback
  • -p, --play
    • Tell a running Ocarina instance to start playback
  • -N, --previous
    • Tell a running Ocarina instance to play the previous track
  • -t, --toggle
    • Tell a paused Ocarina instance to begin playback, or tell a playing Ocarina instance to pause.
  • -v, --version
    • Print Ocarina version and exit


Running make install will install Ocarina for use by all users. There is currently no "uninstall" option.


Running make tests will compile and run the Ocarina unit tests. See the CMake Options section above for additional testing options.