Skip to content
This repository has been archived by the owner on Jul 26, 2021. It is now read-only.

Latest commit

 

History

History
47 lines (26 loc) · 4.01 KB

README.md

File metadata and controls

47 lines (26 loc) · 4.01 KB
Raw

AudioAddict.bundle

This is a Plex Channel plugin that offers a nice interface to the AudioAddict family of music streaming sites, including DI.fm (aka Digitally Imported), RadioTunes.com (formerly Sky.fm), and others.

Discontinuation of support for plugins

In September of 2018, Plex officially announced that the plugin model would be deprecated and "slowly phased out". While plugins can still be manually installed on the server, client support is now spotty at best; as of 2020, the official Plex clients generally do not provide an interface for plugins. Long story short, this plugin technically still works, but you need to use an unoffical client to "see" it—sorry, there's nothing I can about that. :(

Install

Like most plugins, this is currently "unsupported", so the installation process is manual. See the official Plex documentation for more information.

Preferences

There are some preferences that can be set:

  • Listen Key: Your unique key, functionally used as an auth and ident token. It can be obtained from the "player settings → hardware player" section of your favourite AA service. Example: http://www.radiotunes.com/settings
  • Preferred Source: This corresponds to the regional server that you want to stream. You're not obliged to set this, but if you're having bandwidth issues it might help. prem1, prem3, and prem4 are in the USA, while prem2 is in Europe.
  • Preferred Streams: These correspond to the "sound quality & bandwidth" option of the AA service. AAC support is sort of wonky (works on some devices, not on others), so your only safe option (read: MP3) is premium_high.
  • Force Refresh: This will, as the name implies, force a refresh of the service information next time you access it. In practice, this should be used if you modify either (or both) of the Source or Stream preferences at any time. It is possible that this will appear to cause an error of some type (this is due to timeout issues that have been totally ignored—sorry), but it probably worked. Remember to turn it off when you're done.
  • Debug: This will cause additional debug output to be generated—some of it will be visible in the interface, but most of it goes into the logs.

FAQ

Where is the Plex Forum post for this plugin?

https://forums.plex.tv/discussion/107801/rel-audioaddict-radiotunes-com-di-fm-etc/p1

Do I need a Premium account?

Yes. You need a Premium account in order to get the Listen Key. Without that key, all you get are the free streams, which no longer have music on them (just a message on a loop).

I can't play the stream and/or I get a codec error - what's the deal?

As noted above, AAC support is inconsistent across devices, browsers, and clients. The only "safe" option is to use an MP3 stream (though AAC does often work).

I changed settings such as Preferred Stream in the preferences, but it didn't seem to do anything.

As noted above, any time you change a setting in preferences, you'll need to Force Refresh the service(s) you're interested in. Don't worry if it seems like it timed out the first time, and don't forget to turn this flag back off when you're done.

Does this work in Chromecast / iPad / HT / (insert whatever architecture you've got)?

Probably (see AAC vs. MP3 above, however).

AudioAddict API

The sum total of all public knowledge concerning the AA API used to be available here; however, the server disappeared without a trace sometime in 2014. There is an archived copy available on the wayback machine.