A modern audio book player for Linux and macOS using GTK+ 3
Latest commit fb303d7 Nov 1, 2018

README.md

It's getting Cozy

Build Status Patreon donate button AUR

Cozy is a modern audio book player for Linux and macOS.

Screenshot

Get it on AppCenter

Here are some of the current features:

  • Import all your audiobooks into cozy to browse them comfortably
  • Listen to your DRM free mp3, m4a (aac, ALAC, ...), flac, ogg and wav audio books
  • Remembers your playback position
  • Sleep timer!
  • Playback speed control for each book individually
  • Search your library
  • Sort your audio books by author, reader & name
  • Drag & Drop to import new audiobooks
  • Add mulitple storage locations
  • Offline Mode! This allows you to keep an audiobook on your internal storage if you store your audiobooks on an external or network drive. Perfect to listen to on the go!
  • Mpris integration (Media keys & playback info for desktop environment)
  • Developed on Fedora and tested under elementaryOS

How can I get it?

Flatpak

For most distributions you can use Flatpak to install and run cozy: Flathub Or use the following commands:

flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user flathub com.github.geigi.cozy

elementaryOS

If you're running elementaryOS, you can get cozy from the App Center.

Arch Linux

Arch Linux users can find cozy under the name cozy-audiobooks in the AUR:

$ pacaur -S cozy-audiobooks

Ubuntu, Debian, openSUSE, Fedora repositories

If you prefer a custom repository - for Ubuntu, Debian, openSUSE and Fedora there are package repositories on the openSUSE Build Service.

If you like this project, consider supporting me on Patreon :)

macOS

Cozy for macOS is currently on beta. It's tested only on 10.14 Mojave so far and there are some known bugs:

  • no integration in notification center or any other desktop integration really
  • media keys are not working
  • dark mode requires 2x switching in settings + is not loading automatically at startup
  • large Cozy.app

You can download it here: Cozy 0.6.4 beta2 for macOS

Requirements

  • python3
  • pip for peewee
  • meson >= 0.40.0 as build system
  • ninja
  • gtk3 >= 3.18 but fancier with gtk3 >= 3.22
  • peewee >= 3.5 as object relation mapper
  • python3-mutagen for meta tag management
  • python3-gi-cairo
  • file
  • gstreamer1.0-plugins-good
  • gstreamer1.0-plugins-bad
  • gstreamer1.0-plugins-ugly
  • gstreamer1.0-libav for mp4 support

Install requirements on Fedora

sudo dnf install meson glib glib2-devel python3 python3-devel file-libs python3-magic python3-mutagen gtk3 ghc-magic-devel python3-gstreamer1 gstreamer1-plugins-good gstreamer1-plugins-good-gtk gstreamer1-libav
pip3 install --user python-magic libmagic peewee ninja file

Build

$ git clone https://github.com/geigi/cozy.git
$ cd cozy
$ meson desired_build_directory --prefix=desired_installation_directory
$ ninja -C desired_build_directory install

Running a local build

XDG_DATA_DIRS=desired_installation_directory/share:/usr/share PYTHONPATH=desired_installation_directory/lib/python3.[your_python3_version]/site-packages app/bin/com.github.geigi.cozy

Q&A

I have imported wrong files and cannot get rid of them:

Delete the following folders to reset cozy (this will loose all saved progress):

~/.local/share/cozy
~/.cache/cozy

I can't uninstall the Flatpak:

Try

flatpak uninstall com.github.geigi.cozy/x86_64/stable

or

flatpak uninstall --user com.github.geigi.cozy/x86_64/stable

Thanks to @Meresmata

I have my audiobooks in a location that is not accessible in the Flatpak sandbox:

You can override the flatpak settings and allow access to a path (e.g. /media) like this:

flatpak --user override --filesystem=/media com.github.geigi.cozy

A big thanks

To the contributors on GitHub:

  • oleg-krv
  • AsavarTzeth
  • worldofpeace
  • camellan
  • jnbr
  • grenade

The translators:

  • camellan
  • Vistaus
  • Distil62
  • karaagac
  • HansCz
  • mvainola
  • giuscasula
  • abuyop
  • akodi
  • cleitonjfloss
  • amadeussss
  • nvivant
  • Foxyriot
  • mardojai
  • trampover

To nedrichards for the Flatpak.

Help me translate cozy!

Cozy is on Transifex, where anyone can contribute and translate. Can't find your language in the list? Let me know!


Maintainability