# SubDaap

**Repository Path**: mirrors_basilfx/SubDaap

## Basic Information

- **Project Name**: SubDaap
- **Description**: DAAP server/proxy for SubSonic: play your favorite tunes from SubSonic in iTunes!
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## 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.