diff --git a/README.md b/README.md index 05f0e252..e7a94704 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,3 @@ -![Unit Testing](https://github.com/geigi/cozy/workflows/Unit%20Testing/badge.svg)

@@ -8,111 +7,51 @@ # It's getting Cozy +![Unit Testing](https://github.com/geigi/cozy/workflows/Unit%20Testing/badge.svg) +![Flathub Downloads](https://img.shields.io/flathub/downloads/com.github.geigi.cozy?color=e66100&logo=flatpak) + ![Screenshot](https://raw.githubusercontent.com/geigi/cozy/img/img/screenshot1.png) Cozy is a modern audiobook player for Linux. -Head over to [Matrix](https://matrix.to/#/#cozy:gnome.org?via=matrix.org&via=gnome.org) to join the conversation. +Head over to [Matrix](https://matrix.to/#/#cozy:gnome.org) to join the conversation. ## Here are some of the current features: -- **Import** your audiobooks into Cozy to browse them comfortably +- **Import** all your audio books into Cozy to browse them comfortably - **Sort** your audio books by author, reader & name - **Remembers** your **playback position** - **Sleep timer** -- **Playback speed control** +- **Playback speed control** for each book individually - **Search** your library - **Offline Mode!** This allows you to keep an audio book on your internal storage if you store your audiobooks on an external or network drive. Perfect for listening on the go! - Add **mulitple storage locations** - **Drag & Drop** to import new audio books -- Support for DRM free **mp3, m4a (aac, ALAC, …), flac, ogg, opus, wav** files -- Mpris integration (**Media keys** & playback info for desktop environment) +- Listen to your DRM free **mp3, m4b, m4a (aac, ALAC, …), flac, ogg and wav** audio books +- MPRIS integration (**Media keys** & playback info for desktop environment) # Install +The preferred source for installing Cozy is Flathub + +Download on Flathub + +### Distro packages + | Distro | Package | |--------|:---------:| -| Flatpak | Download on Flathub | | openSUSE |
cozy | | Fedora |
cozy | | Arch Linux (AUR) | cozy-audiobooks
| | VoidLinux | cozy | | Solus | cozy | | MX Linux |
Cozy | -| elementaryOS | Currently out of date. Please use Flatpak for now. | | Ubuntu (PPA) |
cozy | | OpenBSD |
cozy | | Nix |
cozy | - -## elementaryOS -The App Center version of Cozy is currently out of date. elementaryOS ships with old versions of dependencies needed by Cozy. Those are not compatible anymore. Therefore I'm unable to update the App Center version to the latest version of Cozy. Please switch over to the Flatpak version for now. If you experience issues with moving your library, let me know! - -elementaryOS is working on a new version of App Center which will be based on Flatpak. When the new App Center is live, Cozy will be back on the app center! :) Thanks for everyone who supported me on the App Center. - -## macOS -**Currently discontinued** - -There is an older beta of Cozy 0.6.7 which is tested on macOS 10.14. It might not work with newer versions of macOS. -Because the build process is rather complicated and not easy to automate I've currently discontinued building for macOS. If you're interested in the build process: have a look at my [writeup](https://gist.github.com/geigi/a3b6d661daeb7b181d3bdd3cab517092). - -Some information about the old beta: - -- 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.7 beta3 for macOS - # Development +See [DEVELOPMENT.md](DEVELOPMENT.md) for detailed instructions about developing Cozy in GNOME Builder, Fedora and Ubuntu -See [DEVELOPMENT.md](DEVELOPMENT.md) for detailed instructions and developing Cozy on Ubuntu. - -## Requirements -- `python3` -- `meson >= 0.40.0` as build system -- `gtk4 >= 4.10` -- `libadwaita >= 1.5.0` -- `peewee >= 3.9.6` as object relation mapper -- `mutagen` for meta tag management -- `distro` -- `requests` -- `pytz` -- `gi-cairo` -- `gst-1.0` -- `file` -- `gstreamer1.0-plugins-good` -- `gstreamer1.0-plugins-bad` -- `gstreamer1.0-plugins-ugly` -- `gstreamer1.0-libav` for mp4 support - -## Bundled Requirements -- `inject`: https://github.com/ivankorobkov/python-inject - -This dependency is bundled because it is not generally available as a linux package. The licence is respected and included. - -## Build - -```bash -$ git clone https://github.com/geigi/cozy.git -$ cd cozy -$ meson --prefix= -$ ninja -C install -``` - -## Update `po` files -```bash -$ ninja -C com.github.geigi.cozy-update-po -$ ninja -C extra-update-po -``` - -## Running a local build -``` -XDG_DATA_DIRS=/share:/usr/share \ -PYTHONPATH=/lib/python3.[your_python3_version]/site-packages \ - app/bin/com.github.geigi.cozy -``` - -## Q&A +## FAQ ### I have imported wrong files and cannot get rid of them: Delete the following folders to reset cozy (this will loose all saved progress): ``` @@ -123,162 +62,26 @@ Delete the following folders to reset cozy (this will loose all saved progress): ### I can't uninstall the Flatpak: Try -``` +```console flatpak uninstall com.github.geigi.cozy/x86_64/stable ``` or -``` +```console flatpak uninstall --user com.github.geigi.cozy/x86_64/stable ``` Thanks to @Meresmata ### I store 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: -``` +```console flatpak --user override --filesystem=/media com.github.geigi.cozy ``` -## A big thanks -To the contributors on GitHub: -- A6GibKm -- alyssais -- apandada1 -- AsavarTzeth -- Fatih20 -- NathanBnm -- camellan -- chris-kobrzak -- elya5 -- foliva -- grenade -- jimmac -- jnbr -- jubalh -- kaphula -- leuc -- magnickolas -- meisenzahl -- naglis -- oleg-krv -- paper42 -- phpwutz -- rapenne-s -- rdbende -- thibaultamartin -- umeboshi2 -- worldofpeace - -The translators: -- Ainte -- AndreBarata -- Andrey389 -- Asyx -- BunColak -- Caarmi -- CiTyBear -- Distil62 -- Fitoschido -- Floflr -- Foxyriot -- HansCz -- IngrownMink4 -- IvoIliev -- Jagadeeshvarma -- Kwentin -- MageJohn -- NHiX -- Nimmerliefde -- Oi_Suomi_On -- Okton -- Panwar108 -- Potty0 -- Sebosun -- TheMBTH -- TheRuleOfMike -- Vistaus -- W2hJ3MOmIRovEpTeahe80jC -- WhiredPlanck -- _caasi -- aKodi -- abcmen -- abuyop -- albanobattistella -- amadeussss -- andreapillai -- arejano -- artnay -- b3nj4m1n -- baschdl78 -- camellan -- cavinsmith -- cho2 -- chris109b -- cjfloss -- ckaotik -- corentinbettiol -- dtgoitia -- dzerus3 -- elgosz -- endiamesos -- eson -- fishcake13 -- fountain -- fran.dieguez -- georgelemental -- giuscasula -- goran.p1123581321 -- hamidout -- hkoivuneva -- jan.sundman -- jan_nekvasil -- jouselt -- karaagac -- kevinmueller -- leondorus -- Sabri Unal -- linuxmasterclub -- magnickolas -- makaleks -- mannycalavera42 -- mardojai -- markluethje -- milotype -- mvainola -- n1k7as -- nikkpark -- no404error -- nvivant -- oleg_krv -- ooverloord -- oscfdezdz -- pavelz -- rafaelff1 -- ragouel -- saarikko -- sobeitnow0 -- sojuz151 -- steno -- tclokie -- test21 -- thibaultmartin -- translatornator -- tsitokhtsev -- twardowskidev -- txelu -- useruseruser1233211 -- vanhoxx -- vlabo -- xfgusta -- yalexaner -- bittin +## Thanks +A big thanks to all the contributors and translators. See the complete list in [AUTHORS.md](AUTHORS.MD) -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! +## Help us translate Cozy! +Cozy is on Transifex, where anyone can contribute and translate. Can't find your language in the list? Let us know! If you like this project, consider supporting me on Patreon :) - ----- -[![Maintainability](https://api.codeclimate.com/v1/badges/fde8cbdff23033adaca2/maintainability)](https://codeclimate.com/github/geigi/cozy/maintainability)