Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://gitlab.com/luciocarreras/sayonara-player

Sayonara is a small, clear and fast audio player for Linux written in C++, supported by the Qt framework. It uses GStreamer as audio backend. Sayonara is open source and uses the GPLv3 license. Learn more at https://sayonara-player.com
https://gitlab.com/luciocarreras/sayonara-player

Last synced: about 1 month ago
JSON representation

Host: gitlab.com
URL: https://gitlab.com/luciocarreras/sayonara-player
Owner: luciocarreras
License: gpl-3.0
Created: 2019-10-03T08:40:12.542Z (about 5 years ago)
Default Branch: master
Last Synced: 2024-08-01T08:13:41.857Z (4 months ago)
Stars: 74
Forks: 18
Open Issues: 22
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- License: COPYING

Awesome Lists containing this project

fucking-Awesome-Linux-Software - ![Open-Source Software - player.com/downloads/) - A small, clear and fast audio player for Linux written in C++, supported by the Qt framework. (Applications / Audio)
Awesome-Linux-Software - ![Open-Source Software - player.com/downloads/) - A small, clear and fast audio player for Linux written in C++, supported by the Qt framework. (Applications / Audio)

README

# Sayonara Player
[https://sayonara-player.com](https://sayonara-player.com)

[![Twitter URL](https://img.shields.io/twitter/follow/SayonaraPlayer?style=social)](https://twitter.com/sayonaraplayer)

![Maintenance](https://img.shields.io/maintenance/yes/2024)
![License](https://img.shields.io/badge/License-GPLv3-green)

![Debian package](https://img.shields.io/debian/v/sayonara/sid)
![Fedora package](https://img.shields.io/fedora/v/sayonara)
![AUR version](https://img.shields.io/aur/version/sayonara-player)

Sayonara is a small, clear and fast audio player for Linux written in C++, supported by the Qt framework. It uses GStreamer as audio backend. Sayonara is open source and uses the GPLv3 license. One of Sayonara's goals is intuitive and easy usablility. Currently, it is only available for Linux and BSD.

## Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

### Prerequisites

In order to compile you need the following packages
* cmake >= 3.8
* g++ >= 7.1 or clang++ >= 6.0
* Qt >= 5.8: Core, Widgets, Network, Xml, Sql, Sqlite, DBus
* Gstreamer development files, GStreamer plugins
* zlib development files

#### Installing packages on Debian/Ubuntu/Mint
```
apt install cmake \
cmake \
gstreamer1.0-plugins-bad \
gstreamer1.0-plugins-ugly \
lame \
libgstreamer1.0-dev \
libgstreamer-plugins-bad1.0-dev \
libgstreamer-plugins-base1.0-dev \
libqt5sql5-sqlite \
libqt5svg5-dev \
libmp3lame0 \
libtag1-dev \
pkg-config \
qtbase5-dev \
qttools5-dev \
qttools5-dev-tools \
vorbis-tools \
zlib1g-dev
```

#### Installing packages on Fedora/Suse
```
dnf install \
cmake \
desktop-file-utils \
gcc-c++ \
gstreamer1-plugins-base-devel \
hicolor-icon-theme \
libappstream-glib \
qt5-qtbase-devel \
qt5-qttools-devel \
taglib-devel \
zlib-devel
```

optional: gstreamer1-plugins-ugly lame (use rpmforge or rpmfusion)

#### Installing packages on Mageia
```
urpmi \
appstream-glib \
cmake \
desktop-file-utils \
gcc-c++ \
lib64 \
lib64gstreamer1.0-devel \
lib64gstreamer-plugins-base1.0-devel \
lib64qt5base5-devel \
lib64qt5core-devel \
lib64qt5dbus-devel \
lib64qt5gui-devel \
lib64qt5help-devel git
lib64qt5network-devel \
lib64qt5network-devel \
lib64qt5sql-devel \
lib64qt5xml-devel \
lib64zlib-devel
```

### Get the source code

#### Archive
A source code archive can be fetched from Gitlab [https://gitlab.com/luciocarreras/sayonara-player]() or from the [Sayonara homepage](https://sayonara-player.com/downloads.php). The archive is extracted by using

`tar xzf sayonara-player-.tar.gz`

#### Git
The source code can also be fetched via git from Gitlab [https://gitlab.com/luciocarreras/sayonara-player.git](). Sayonara's own Git repository will not be accessible anymore in the future.

##### Cloning
Fetch the source code via

`git clone https://gitlab.com/luciocarreras/sayonara-player.git`

If you are told to use another branch (typically beta or testing), use

`git clone https://gitlab.com/luciocarreras/sayonara-player.git -b `

### Build Sayonara
```
mkdir build
cd build
cmake ..

make -j
make install
```

#### Additional useful CMake arguments:
* Build Type: `-DCMAKE_BUILD_TYPE=Debug|Release|RelWithDebSymbols`
* Install prefix: `-DCMAKE_INSTALL_PREFIX=`
* Enable/Disable testing: `-DWITH_TESTS=ON|OFF`
* Enable/Disable documentation: `-DWITH_DOC=ON|OFF`

* Choose another compiler: `-DCMAKE_CXX_COMPILER=`
* Use a different Qt installation: `-DCMAKE_PREFIX_PATH= -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=ON`

### Running tests
`make test`

## Versioning
Version scheme is `..-[beta|stable]`

where `` marks really big changes, `` marks changes which may affect stability, `` marks changes which do not affect stability and `` marks a single bugfix

## Authors
**Michael Lugmair** - *Project owner* sayonara-player at posteo dot org

## License
This project is licensed under the GPL Version 3 License - see the [LICENSE](LICENSE) file for details