https://github.com/ioggstream/iposonic

A tiny subsonic server api implementation with python + flask
https://github.com/ioggstream/iposonic

Last synced: 2 months ago
JSON representation

A tiny subsonic server api implementation with python + flask

• Host: GitHub
• URL: https://github.com/ioggstream/iposonic
• Owner: ioggstream
• Created: 2012-08-19T15:55:35.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2016-08-20T21:02:32.000Z (over 8 years ago)
• Last Synced: 2024-10-15T03:43:00.646Z (3 months ago)
• Language: Python
• Size: 3.56 MB
• Stars: 28
• Watchers: 10
• Forks: 11
• Open Issues: 11
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
iposonic

========

A tiny subsonic server api implementation with python + flask.

Supports:

* coverArt search on the web

* playlist add / delete, 4 default dynamic meta - playlist(included starred and random)

* simple and customizable authentication

* mp3 down - sampling for streaming from GPRS / UMTS connections

* rating and starring

* full - text search songs and albums

* optional database backends

It works nicely for listing and playing your files with a subsonic client.

* Android client

* MiniSub and Perisonic

quickstart

==========

To run, just

* install flask and the other dependencies with

           # pip install flask

* configure your mp3 directory in webapp.py

* run with

           # python main.py -c /music/folder

* help yourself

           # python main.py --help

You can test methods adding some audio files in test / data / and messing with nose

prerequisites

============

Required

* pip install flask

* pip install mutagen

* pip install simplejson

* pip install argparse

Optional

* pip install sqlalchemy       # [optional if you want a permanent store]

* pip install MySQL - python     # [optional if you want MySQL support]

* pip install pylast             # [optional if you want to scrobble to last.fm]

* pip install nose             # [to test and develop]

* [apt - get | yum] install lame   # [optional if you want transcoding and down-sampling]

big collections

===============

If you have big music collections, Iposonic supports local data indexing with

* MySQL Embedded(library provided in this source, with full text search)

* MySQL Server(configure it in MySQLIposonicDB class)

* Sqlite(thru sqlalchemy, but does not support full text search)

scrobbling

==========

Scrobbling is enabled on development branches: lastfm and fs_thread