A GTK+ / GStreamer based music player

Anna 386514ac5c Ocarina 6.5.7-rc 2 weeks ago
core a8f94e9443 core/audio: Add a function to load tracks by filepath 2 weeks ago
gui 7558a32940 gui/ocarina: Load filepaths from the command line 2 weeks ago
include a8f94e9443 core/audio: Add a function to load tracks by filepath 2 weeks ago
share 8b17962b4e gui/sidebar: Don't set user playlists as editable by default 4 weeks ago
tests a8f94e9443 core/audio: Add a function to load tracks by filepath 2 weeks ago
.gitattributes cb6d8b3e29 Ocarina 6.3 2 years ago
.gitignore 2f559b2fb3 tests: Build version test with CTest 1 year ago
.gitlab-ci.yml 2e38b3551e tests: Add a switch for disabling GUI tests 1 year ago
CHANGELOG be3b788380 core/playlists/system: Don't read 6.4.x playlists in new idle tasks 11 months ago
CMakeLists.txt 386514ac5c Ocarina 6.5.7-rc 2 weeks ago
CTestCustom.cmake fc88f68d6b tests: Build file test with ctest 1 year ago
LICENSE 08a69c2c81 Update the license 3 years ago
PKGBUILD 36349e9890 Ocarina 6.5.6 2 weeks ago
README.md 63951568af Replace README with README.md 10 months ago
TODO 5a41eef8a2 gui/ocarina: Add basic command line options 1 year ago
ocarina.supp 59b2c854e7 Add a valgrind suppression file 11 months ago

README.md

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.

Git

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
Branches
  • [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.

Building

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.

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

Running

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

Installing

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

Testing

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