Connecting to a Server

Connecting AVSub to your licensed Subsonic server take just four steps

1 - Launch AVSub

When you launch AVSub without a configured server, you will see this screen. An error message will be displayed asking you to check your server details.

Tap the Settings icon to move to the server configuration screen.

2 - Server Configuration

This is where you tell AVSub about your Subsonic server, providing the address, username and password. Consider creating a user just for AVSub.

You can also provide a secondary address for the same server, which AVSub will try if it can't connect to the primary address.

3 - Provide Server Details

Once the server details are entered, tap the Connect button to save the details. You can clear the form with the Reset button or cancel with a tap of the back arrow.

4 - Configuration Complete

Tapping Connect will automatically return you to the main screen. AVSub will then validate your settings and all options should be enabled. If an error is displayed, AVSub has failed to connect to your server - check the settings and try again.

Music Folders

If you've got more than one top-level music folder defined in Subsonic, AVSub allows you to browse them individually or all together.

Initial Media Selection

When you first select Media Index from the main screen you will be presented with this screen. By default All Media is selected, which is all of your media combined together.

Changing Music Folder & Setting Media Type

Tapping the folders button will show the list of folders in Subsonic. Selecting a folder will reload the index from the folder chosen and hide the Music Folder selection options. Your selected folder will be saved as your default folder and the folders name will be displayed at the top of the screen.

You can also select the media type of the folder. By default, Audio will be selected but you can also select Movies or TV. See enhanced movie information for more details.

Show List Instead of Letters

You can toggle between letters and an actual list of directories/artists by tapping the List/Letters button.


AVSub can cache your music locally either as you play or by downloading directly. You can easily manage whats in the cache too, using familiar gestures.

Configuration / Cache As You Play

Cache reading, writing and size is controlled from the Settings section. If cache writing is enabled, then tracks will be cached as you play them. You can also download directly without playing, which is much quicker. See below.

You can setup caching so that the oldest items (i.e the tracks played the least) are automatically deleted to make space for new items.

Direct Download

When browsing your music, a left-to-right swipe on an album or track will reveal a download icon. Press it to download straight into the cache at maximum speed.

AVSub will not recursively download the contents of folders, but only what's directly in the folder selected. The only exception to this is when a folder contains a single folder - AVSub will automatically look in the sub folder (e.g where you have an artist folder with a single album folder inside).

Playing from the Cache

AVSub always checks if it has a cached version of a song before it plays it (as long as Cache Reading is enabled). So, even if you're not browsing the cache, if you have a cached version, this is where it will be played from.

You can browse the cache directly by selecting the Cache section from the main screen. You do not need to be connected to a network to play using this method as everything you need is stored on your phone.

Cache Management

You can manage the contents of the cache from within the Cache section. Simply swiping right-to-left on a track or album will show a delete button.

Note that deleting from the cache does not delete the album art. This is to ensure smoother browsing of directories. You can clear all cached album art from the Settings.

Completely Clear the Cache

You can completely clear the cache in the Settings section.

You can also clear other cached data such as Last.FM data, art or movie data.

Now-Playing Queue

AVSub plays from a queue that you can add tracks to anywhere in the application. You can also view the queue and re-order or delete tracks from it. It even works in Jukebox mode!

Adding to the Queue

If you want to add a track or album to the queue, simply browse to it then swipe from left to right on the track to reveal the add options. You can either add-next or add-end.

Adding a Whole Album

If you're in the album view, you can add the whole album by swiping on the Album Information row at the top.

Viewing the Queue

To view the queue, swipe-down on the header text, or long-press on the now-playing icon.

Managing the Queue

First display the queue as detailed above. You can change the current track by just selecting one from the list. To change the queue there are two modes - move and delete.

In move mode, press and drag the icon at the right of the row to change the position of a track.

Managing the Queue

In delete mode swipe from right to left to reveal a delete button. You can toggle the mode by pressing the icon in the top-right of the Now-Playing Queue screen.

Google Cast/Amazon FireTV Transcoding Setup

To get the smoothest Chromecast video experience, you'll need to setup a new transcoder in Subsonic to ensure everything it converted to a format the cast device can play. Just follow the guide below and you'll be streaming in no time.

1 - Create a user in Subsonic just for Google Cast/FireTV

In Subsonic, navigate to Settings > Users and create a new user just for Chromecast. Make sure that this user has access to all the folders you'd like to cast media from. Click the image to enlarge.

2 - Create a new transcoder for Cast video

In Subsonic, navigate to Settings > Transcoding and create a new transcoder with the following settings. Click the image to enlarge.

Name: Chromecast
Convert from: avi mpg mpeg mp4 m4v mkv mov wmv ogv divx m2ts
Convert to: x264
Step 1: ffmpeg -ss %o -i %s -c:v libx264 -preset superfast -b:v %bk -c:a aac -strict -2 -f matroska -threads 0 -

Untick Enable this transcoding for all existing and new players then click Save.

3 - Configure AVSub to use your new user for your cast device.

In AVSub, navigate to the settings and scroll to the bottom to show the Chromecast/FireTV settings.

Enter the username and password for the user you created in step 1.

4 - Register the Chromecast Player in Subsonic

In AVSub, connect to your Chromecast from the main menu and play some media. This can be an audio track or a video (probably won't work yet). We're doing this just to register the new user as a player in Subsonic.

5 - Assign the new Transcoder to the Chromecast Player

In Subsonic, navigate to the Settings > Players.

In the Select player drop-down menu, there should be an entry called microSub[<the username you created in step 1>]. Select it.

At the bottom of the window is a section called Active transcodings. Ensure that Chromecast is ticked, then click Save.

6 - Setup is complete!

AVSub is now setup to use a specific user with Chromecast and Subsonic will automatically transcode any video to a cast-friendly format.

Subsonic Setup

AVSub streams your music from a Subsonic server - a free, multi-platform music streaming server.


For downloads, installation guides and other documentation, please visit the Subsonic webiste -