A lightweight audio player for local files, running in the terminal
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Cédric Marie 8e24e2ada9 Remove ondine prefix from local callback pointers 2 weeks ago
src Remove ondine prefix from local callback pointers 2 weeks ago
CHANGELOG.md Convert reStructuredText files to Markdown 3 weeks ago
COPYING Create a basic project with Meson 1 year ago
README.md Convert reStructuredText files to Markdown 3 weeks ago
meson.build Get the 'player' state directly from the 'ui' 2 weeks ago

README.md

Ondine

Ondine is a lightweight audio player for local files, running in the terminal.

License

Copyright © 2020-2021 Cédric Marie cedric@hjuvi.fr.eu.org

Ondine is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Ondine is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Ondine. If not, see http://www.gnu.org/licenses/.

Requirements

Ondine uses Meson build system. In order to build the program from the source code, you have to install Meson package, and the development packages for GLib 2.0 and GStreamer 1.0:

  • On Debian: meson libglib2.0-dev libgstreamer1.0-dev
  • On Fedora: meson glib2-devel gstreamer1-devel

Building and installing

You can build and install the program for the current user in its ~/.local directory. By default, the build type is "release", and the program is stripped:

$ meson --prefix=$HOME/.local build
$ ninja -C build install

Usage

To play audio files:

$ ondine [file/directory]...

For more information, you can print the help:

$ ondine --help

Debugging

For debugging purposes, you can also build the program with the "debug" build type (which includes traces):

$ meson --buildtype=debug --prefix=$HOME/.local build
$ ninja -C build install

When you're running this version, the traces are sent to stderr. You can record them in a file, so that they won't mix with the output of the program:

$ ondine [file/directory]... 2> /path/to/log.txt

Support

To report a bug, or suggest an improvement, please send an email to the address mentioned at the beginning of this file.