1
0
Fork 0
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 3a923f3a32 Version 1.3.0 3 months ago
src Version 1.3.0 3 months ago
CHANGELOG.md Version 1.3.0 3 months ago
COPYING Create a basic project with Meson 3 years ago
README.md Version 1.3.0 3 months ago
meson.build Version 1.3.0 3 months ago
user-install.sh Rename the install/uninstall scripts 3 months ago
user-uninstall.sh Rename the install/uninstall scripts 3 months ago

README.md

Ondine

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

GStreamer is used for the audio playback and the parsing of metadata. GLib, which is already a dependency of GStreamer, is also used for the keyboard input.

The display is simply managed by printf, and does not use any library such as ncurses.

License

Copyright © 2020-2022 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

By default, the build type is release, and the program is stripped.

You can build and install the program in your ~/.local directory, by executing this script:

$ ./user-install.sh

You can also use meson and ninja commands directly. This script is just a "helper".

If you want to clean the build and uninstall the program, you can execute this other script:

$ ./user-uninstall.sh

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), by executing:

$ ./user-install.sh debug

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.

About

Ondine was named after a piano piece by Maurice Ravel.