387a5e3de3
- Fixes zip downloads failing when zipping enough data that Zip64 extensions are required by automatically enabling them if needed. - Fixes zip downloads failing when a file has a datestamp that zipfiles cannot store (pre-1980 or post-2108) by clamping them within the supported range. - Massively speeds up zip downloads by disabling compression (audio files generally don't compress well anyway) - Computes the total size of a generated zip file before streaming it and sets the `Content-Length` header. This allows clients to show a final size and progress bar while downloading, as well as detect if the download fails. - Adds a check to prevent sending an empty zip file to the client if there was no content to download (will error out instead). |
||
|---|---|---|
| .github/workflows | ||
| bin | ||
| cgi-bin | ||
| docs | ||
| supysonic | ||
| tests | ||
| .coveragerc | ||
| .gitignore | ||
| ci-requirements.txt | ||
| config.sample | ||
| LICENSE | ||
| MANIFEST.in | ||
| README.md | ||
| setup.py | ||
| supysonic-daemon.service | ||
Supysonic
Supysonic is a Python implementation of the Subsonic server API.
Current supported features are:
- browsing (by folders or tags)
- streaming of various audio file formats
- transcoding
- user or random playlists
- cover art
- starred tracks/albums and ratings
- Last.FM scrobbling
- Jukebox mode
Supysonic currently targets the version 1.10.2 of the Subsonic API. For more details, go check the API implementation status.
Documentation
Full documentation is available at https://supysonic.readthedocs.io/
Quickstart
Use the following commands to install Supysonic, create an admin user, define a library folder, scan it and start serving using Gunicorn.
$ pip install git+https://github.com/spl0k/supysonic.git
$ pip install gunicorn
$ supysonic-cli user add MyUserName
$ supysonic-cli user setroles --admin MyUserName
$ supysonic-cli folder add MyLibrary /home/username/Music
$ supysonic-cli folder scan MyLibrary
$ gunicorn -b 0.0.0.0:5000 "supysonic.web:create_application()"
You should now be able to enjoy your music with the client of your choice!
But using only the above commands will use a default configuration and especially storing the database in a temporary directory. Head over to the documentaiton for full setup instructions, plus other options if you don't want to use Gunicorn.
Note that there's also an optional daemon that watches for library changes and provides support for other features such as the jukebox mode.
Development stuff
For those wishing to collaborate on the project, since Supysonic uses Flask you can use its development server which provides automatic reloading and in-browser debugging among other things. To start said server:
$ export FLASK_APP="supysonic.web:create_application()"
$ export FLASK_ENV=development
$ flask run
And there's also the tests:
$ python setup.py test
$ python setup.py test --test-suite tests.with_net