https://github.com/basilfx/subdaap

DAAP server/proxy for SubSonic: play your favorite tunes from SubSonic in iTunes!
https://github.com/basilfx/subdaap

Last synced: about 1 year ago
JSON representation

DAAP server/proxy for SubSonic: play your favorite tunes from SubSonic in iTunes!

• Host: GitHub
• URL: https://github.com/basilfx/subdaap
• Owner: basilfx
• License: mit
• Created: 2014-08-12T00:27:26.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2019-07-26T05:08:46.000Z (almost 7 years ago)
• Last Synced: 2025-03-24T17:01:45.018Z (about 1 year ago)
• Language: Python
• Size: 256 KB
• Stars: 13
• Watchers: 4
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# SubDaap

DAAP server/proxy for SubSonic: play your favorite tunes from SubSonic in iTunes!

[![Build Status](https://travis-ci.org/basilfx/SubDaap.svg?branch=master)](https://travis-ci.org/basilfx/SubDaap)

The motivation for this application comes from the fact that SubSonic does not ship a DAAP server, and OS X clients for SubSonic lack features, in my opinion. And after all, iTunes is a pretty intuitive and stable player.

## Features

* Compatible with SubSonic 5.3+ and iTunes 12+, including password protection and Bonjour.

* Artwork support.

* Playlist support.

* Browse the whole library in iTunes at once.

* Supports gapless playback.

* Smart file caching: supports in-file searching and concurrent access.

* Revision support: efficient library updates pushed to all connected clients.

## Requirements

* Python 2.7+ (not Python 3.x). PyPy 2.5+ may work.

* SubSonic 5.3+

## Installation

This application was designed as a gateway between SubSonic and iTunes. Therefore, it's recommended to install this on the same system where you would access iTunes on. It can be installed on a central server, however.

* Clone this repository.

* Install dependencies via `pip install -r requirements.txt`.

* Copy `config.ini.default` to `config.ini` and edit as desired.

* `chmod 700 config.ini`, so others cannot view your credentials!

To start this service when your computer starts:

* On OS X:

  * Copy `init-scripts/init.osx` to `~/Library/LaunchAgents/com.basilfx.subdaap.plist`. Do not symlink!

  * Edit the file accordingly. Make sure all paths are correct.

  * Run `launchctl load  ~/Library/LaunchAgents/com.basilfx.subdaap.plist`

* On Ubuntu:

  * Copy `init-scripts/systemd.service` to `/etc/systemd/system/subdaap.service`.

  * Edit the file accordingly. Make sure all paths are correct and the user and group `subdaap` exists and have the correct file permissions.

  * Run `systemctl enable subdaap`.

## Run the application

To run the application, use the following command, or similar:

```

python SubDaap.py --config-file config.ini --data-dir path/to/datadir --pid-file /var/run/subdaap.pid

```

The data directory should exist. Optionally, add `-v` for verbose, or `-vv` for more verbose. All paths in the command line are relative to where you run it from. Any paths in `config.ini` are relative to the `--data-dir`.

Add `--daemon` to run the program in the background.

## Contributing

Feel free to submit a pull request. All pull requests must be made against the `development` branch. Python code should follow the PEP-8 conventions.

## License

See the `LICENSE` file (MIT license).

The web interfaces uses the [Pure.css](http://purecss.io/) CSS framework.