A GTK+ / GStreamer based music player
Go to file
Anna Schumaker 3286b61dcf core/playlist: Add playlist_generic_{alloc,free}() functions
Artist and library playlists are allocated manually, so there should be
generic functions that both can use to get a playlist pointer and free
it when we're done.

I also add a callback for telling the UI when new playlists have been
allocated.  This isn't needed for Library playlists, but this is the
only way the UI can know about new Artists.

Signed-off-by: Anna Schumaker <Anna@NoWheyCreamery.com>
2017-05-13 08:45:04 -04:00
core core/playlist: Add playlist_generic_{alloc,free}() functions 2017-05-13 08:45:04 -04:00
gui core/playlist: Add playlist_generic_{alloc,free}() functions 2017-05-13 08:45:04 -04:00
include core/playlist: Add playlist_generic_{alloc,free}() functions 2017-05-13 08:45:04 -04:00
share gui/artwork: Rework importing album art 2017-04-14 13:58:05 -04:00
tests core/playlist: Add playlist_generic_{alloc,free}() functions 2017-05-13 08:45:04 -04:00
.gitattributes Ocarina 6.3 2015-01-16 13:05:43 -05:00
.gitignore tests: Build version test with CTest 2016-09-23 16:11:02 -04:00
.gitlab-ci.yml tests: Add a switch for disabling GUI tests 2016-09-26 08:26:45 -04:00
CHANGELOG core/playlists/system: Don't read 6.4.x playlists in new idle tasks 2016-10-21 11:31:11 -04:00
CMakeLists.txt Ocarina 6.5.4 2017-05-13 08:42:01 -04:00
CTestCustom.cmake tests: Build file test with ctest 2016-09-23 16:11:02 -04:00
LICENSE Update the license 2014-04-06 19:57:06 -04:00
PKGBUILD Ocarina 6.5.4 2017-05-13 08:42:01 -04:00
README.md Replace README with README.md 2016-10-29 17:17:46 -04:00
TODO gui/ocarina: Add basic command line options 2016-09-26 08:07:36 -04:00
ocarina.supp Add a valgrind suppression file 2016-09-29 14:51:23 -04:00

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:

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.