Settings

Web Interface changes require a restart to take effect. Saving settings will restart intervals if changed.
Basic
Use 0.0.0.0 to allow outside connections
API
Current API key:
Interval An interval of 0 will disable a task.
mins minimum is 360 minutes
mins
hours
hours
days
Usenet Sabnzbd NZBget Black Hole
usually http://localhost:8080
usually http://localhost:6789
Folder your Download program watches for NZBs
Full path where SAB or NZBget downloads your music, e.g. /Users/name/Downloads/music
Bandcamp
Full path where raw MP3s will be stored, e.g. /Users/name/Downloads/bandcamp
Torrents Black Hole Transmission uTorrent (Beta) Deluge QBitTorrent
Folder your Download program watches for Torrents
Note: Opening magnet URLs is not suitable for headless/console/terminal servers.
Embed only works for rTorrent.
usually http://localhost:9091
Note: With Transmission, you can specify a different download directory for downloads sent from Headphones. Set it in the Music Download Directory below
Note: uTorrent may keep files read only when completed. Check 'Preferences -> Advanced -> bt.read_only_on_complete' in case of problems.
usually http://localhost:9091
Note: Works with WebAPI Rev 11 and later (QBitTorrent 3.4.0 and later)
usually http://localhost:8081
Usually http://localhost:8112 (requires WebUI plugin)
Path to the certificate file. Make sure to use a valid certificate ("Issued To" field must match hostname) which is not the case with the default certificate. Path is usually %appdata%\deluge\ssl on Windows, ~/.config/deluge/ssl/ on Linux. Leave this blank if you are using a self-signed certificate.
Note: With Deluge, you can specify a different download directory for downloads sent from Headphones. Set it in the Music Download Directory below
Labels shouldn't contain spaces (requires Label plugin)
Directory where Deluge should download to
Directory where Deluge should move completed downloads
Number of minimum seeders a torrent must have to be accepted
Full path where your torrent client downloads your music e.g. /Users/name/Downloads/music.
NZBs Torrents Soulseek No Preference
Soulseek
NZBs
Headphones VIP Server username & password
Don't have an account? Sign up!
e.g. http://nzb.su
Other
Torrents
Optional. Leave empty for default.
e.g. http://localhost:9117/api/v2.0/indexers/demonoid/results/torznab/
Quality
Reject if target size is not in bitrate range: to kbps
Target bitrate: kbps
Reject if less than % or more than % of the target size (leave blank for no limit)
Search Words Separate words with a comma, e.g. "word1,word2,word3".
Results with any of these words in the title will be filtered out
Results with these words in the title will be preferred over results without them (search provider names can also be entered)
Results without these words in the title will be filtered out. You can use OR: 'flac OR lossless OR alac, vinyl'
Post-Processing
as .jpg
Use $Artist/$artist, $Album/$album, $Year/$year, put optional variables in curly braces, use single-quote marks to escape curly braces literally ('{', '}').
Album art min width Album art max width
The directory where Headphones will move file to after post processing, e.g. /Volumes/share/music.
Optional. Set this if you have a separate directory for lossless music.
e.g. http://localhost:8080. Separate hosts with commas
e.g. http://localhost:9000. Seperate hosts with commas
Separate multiple api keys with commas
Enter the path/application name to be registered with the Notification Center, default is /Applications/Headphones
Host running Plex Media Server (eg. http://192.168.1.100:32400)
Host running Plex Client (eg. http://192.168.1.100:3005)
Username of your Plex client API (blank for none)
Password of your Plex client API (blank for none)
Plex Token (for use with Plex Home)
Separate multiple api keys with commas
Leave blank to send to all devices
Contact @BotFather to create a bot and get its token
Contact @myidbot to get your user ID
Comma separated list. Leave blank to send to all devices
Renaming options
Use: $Artist/$artist, $SortArtist/$sortartist, $Album/$album, $Year/$year, $Type/$type (release type) and $First/$first (first letter in artist name), $OriginalFolder/$originalfolder (downloaded directory name). Put optional variables in curly braces, use single-quote marks to escape curly braces literally ('{', '}').
E.g.: $Type/$First/$artist/$album{ '['$year']'} = Album/G/girl talk/all day [2010]
Use: In addition to the above, there is also $Title/$title (track title), $Track (track #), $Disc (disc #), $DiscTotal.
Re-Encoding Options Note: this option requires the lame, ffmpeg or xld encoder

Set equal to the number of cores, or 0 for auto
Audio Properties
Advanced Encoding Options
Ignores all of the above options
If different from format selected above
Miscellaneous
Single
Ep
Compilation
Soundtrack
Live
Remix
Spokenword
Audiobook
Other
Dj_mix
Mixtape_street
Broadcast
Interview
Demo
Directories
Last.fm
Songkick
Find Area ID
Musicbrainz


Get an Account!
Back to top