Stellarworks

NAP Help File

This skinnable ad supported music player features an integrated local network client, an FTP client and Chromecast support. Allowing users to connect to their home network, over a Wifi or Mobile connection, and stream or download music straight to their phone or tablet, or stream music to their TV using Chromecast. Network files can be downloaded, renamed, deleted and login details can be saved for quick access at a later date. The program also features a file browser, which can unzip, rename and delete local files. The App supports the following audio formats: mp3, mp4, m4a, ogg, wav, flac (Android 3.1+), and mid.


Support
support@stellarworks.com.au
Support Web Page


Contents
Key Features
Version History
How to Add a Song
How to Connect to a Network
How to Download a File
How to Stream a Song
How to Make a Skin
Chromecast Support
Web Browser (NAP Pro Only)
Playing Tab
General Options
Playlist Tab
Playlist Options
Streaming Options
Network Tab
FTP Options
Network Options
Synchronizing Network Folders
Widget
How to Add a Widget
Troubleshooting & FAQ


Key Features
  • Stream songs over the Local Network using shared files or over the Internet using FTP.
  • Supports mp3, mp4, m4a, ogg, wav, flac (Android 3.1+) and mid audio files.
  • Chromecast Support (mp3, m4a, ogg, wav). Stream your device's songs or network songs to your TV.
  • Browse Local Networks for Shared Files and Folders.
  • Browse FTP servers over the Internet or Local Network.
  • Unzip, rename, and delete Local Files.
  • Download, rename and delete Network Files.
  • Save Network usernames, passwords and addresses for quick access.
  • Save & Load Playlists to/from external files.
  • Automatically Synchronize your Playlist with network folders.
  • Small and Large Widget with Player Controls and alternate skins.
  • Skinnable Interface.


Version History
v3.33 - May 5, 2015
  • Added higher resolution icons and made minor UI tweaks.


v3.32 - April 15, 2015
  • HTTP Streaming now works with redirected, rewritten, and indirect/attachment links (with correctly set mime types).
  • Now checks for Wifi redirection/sign in page by trying to access google.com.
  • Download under Web Browser->Page Action and webpages with an attachment now ask for filename and extension.
  • URLs with no extension or filename will use a timestamp for the name and the mime type for extension.
  • Fixed a small bug with the way the Web Browser checked for internet access.


v3.31 - March 17, 2015
  • Fixed a bug with Streaming Songs that caused them to buffer forever in certain specific circumstances.
  • Fixed a bug with the Playlist listview not restoring scroll position on KitKat+.
  • Fixed several bugs involving transfers.
  • Added Bookmarks, User History, and Download Web Page to Web Browser.
  • Fixed search Webpage and Help not working on KitKat.
  • Corrected the Web Browser's relative URL construction for 'Add Songs' and 'Download Songs'.
  • Album Artwork Dialog now scales album art to fill image view.
  • Added FTP Read Timeout and changed the way FTP navigation while downloading is handled.
  • Added Allow Mobile Data Use option to Network Options.
  • Increased Streaming Songs starting buffer to 512kb.


v3.3 - February 2, 2015
v3.2 - October 24, 2014
v3.1 - July 30, 2014
v3.0 - December 19, 2013
v2.08 - June 14, 2013
v2.07 - March 8, 2013
v2.06 - January 16, 2013
v2.05 - December 19, 2012
v2.04 - June 8, 2012
v2.03 - March 23, 2012
v2.01 & v2.02 - February 10, 2012
v2.0 - January 20, 2011
v1.0 - November 21, 2011



How to Add a Song
Songs can be added to a new or existing Playlists through the Playlist tab. After selecting this tab bring up the options menu using the mechanism relevant to your mobile device. Several options will be displayed, one of which is called 'Add Song(s)'.


Selecting this item will display the File Browser activity, which allows you to navigate the files and folders stored on your device's SD card (filtered to only display compatible audio files). The contents of the current directory are displayed in a list, with folders being listed first with their names proceeded by a folder icon. Touching one of the listed folders will change the current directory to the selected folder, displaying it's contents in kind. Pressing the 'Up Directory' button or icon will change the current directory to the previous directory/the current directory's parent. Multiple files and folders can be selected within the current directory, and any selected folders will be recursively searched for other files and folders to add. Pressing the 'OK' button will add any selected objects to the current Playlist, while pressing the 'Cancel' button will close the File Browser activity. The 'Add All' button will add all files and folders in the current directory, while the 'Add All Files' button will only add the files in the current directory.



How to Connect to a Network
To connect to a Local Area Network (LAN), you must first establish a WiFi connection. To do this bring up the Main menu and select 'Settings', then select 'Wireless & networks' which should be listed at the top. In the new menu make sure 'Airplane mode' is unticked and 'Wi-Fi' is ticked. If your device is not already connected to a Wifi network, select the 'Wi-Fi settings' option. This menu item will display a list of Wifi networks in range. Select the network that belongs to you, and enter in your pass key if prompted to do so (some ISP routers will display this code on their bottom side). The selected network should then say 'Connecting', 'Obtaining IP Address', before finally saying 'Connected'. Exit out of all the settings menus, and return to the Main Menu. Scroll up to NAP and launch the application.



Once connected to a Wifi network and inside NAP, select the Network tab. The button to the left of the textbox on this screen switches the program between FTP mode and LAN mode. When in LAN mode, press the 'Touch to Discover Network' area to discover the local network or enter a NetBios name/IP Address into the textbox and press the 'Access' button. Or enter an FTP address into the 'FTP Address' textbox when in FTP Mode, and press the 'Access' button. In either mode it may take a few seconds for the program to display anything, and it may prompt you for a username, password and domain name that is valid for the network computer or FTP Server.

Whether using 'Discover' or 'Access' the results of the action will be displayed in a list below the textbox. As with the File Browser, network folders are listed first and are proceeded with a folder icon and a touching the directory name will change directories. Returning to a previous directory is achieved by touching the '..' entry or up arrow, which is always the first entry in the list. Changing network directories may take a number of seconds to happen, depending on the size of the new directory. The files displayed, like the File Browser, can be filtered to show only compatible audio files when the Song Filter option is enabled. Touching a file will select it, and allow you to perform operations on it via the Options Menu (under File Actions) or the Context Menu.



How to Download a File
To Download a file or folder, first select the desired items in the Network Tab's list and then bring up the options menu using the mechanism relevant to your mobile device. One of the items in this menu is 'Download'. Selecting this item will display the File Browser activity. In this instance, the File Browser will let you choose which folder the downloaded files and folders will be stored in on the SD card. It wont let you select more than one destination, and the names of the downloaded files and folders are automatically given the same as their network parent. Any local files with the same name will be overwritten (NAP Pro allows files to be Resumed), and network folders are recursively downloaded - all subdirectories and files are also downloaded. Any downloaded songs are automatically added to the current playlist on completion.

Once a Download begins the File Transfer icon will be displayed at the top of the screen and in the Android Notification Area. Touching either of these items will show the Transfer Activity, which displays the current file being transferred, it's size and current progress and any files waiting to be downloaded. The Transfer Activity can be removed by pressing the X button at the top of the screen or pressing the Back button, allowing the download to continue in the background while the application is running. Any current or pending downloads will be cancelled when the application is closed. This doesn't happen in NAP Pro, which can also resume interrupted file transfers.



How to Stream a Song
To Stream a file you must first setup file sharing on the computer(s) that contain your music collection. A Google search will explain how. After sharing the folder that contains your music, select the Network tab. Enter your computer's IP address or discover the local network and browse to your computer. One of the directories displayed should be your music folder. Touching a the folder will display the contents of it, which may take some time for large folders. Select any songs and folders you wish to add to the playlist (by touching them) and then bring up the Options Menu or Context Menu. Select 'Add to Playlist', and the program will find any songs, in any subdirectories, and add them to the current playlist.

When playing any network songs they will buffer for a moment while they begin to download, before starting to play. You wont be able to seek/skip the length of a streaming song until it finishes downloading, for some file types. By default five songs are cached locally, and if they have been completely downloaded, will not require network access to play.



How to Make a Skin
NAP Skins are incredibly flexible and easy to make. They can replace a few colours and images, or they can replace them all, including elements used in the Widgets. The Skin is described in a text file using tags similar to html (eg <albumicon> [insert_file_here] </albumicon>), so it's also trivial to edit.

To start making a skin download the source skin or example skin zip file from our website. This file contains all the image elements in the original skin that can be replaced. These images also serve as a size guide for making new icons and images. The amount of space - both in screen and memory size - is limited on mobile devices, so bear this in mind when making background images in particular. You may wish to make separate skin versions for large screen devices such as tablets. Also note that the screen of a mobile device can be rotated, so background images may be stretched.

As mentioned earlier, the skin is described in a text file using xml tags with the file extension '.snap'. A skin file with all the available tags can be found with the source skin file. Opening this file, you can see that it contains things like '<previewimage> </previewimage>' and '<currentsongtab> </currentsongtab>'. These tags denote which interface element should be replaced, or describe who made the file etc. It's pretty self evident what each tag does. Most tags do not have to be present - missing tags mean the respective default skin element will be used - but the root tag '<napskin>' and the header tags ('<napskinversion>' etc) must be there.

Inbetween each pair of tags is where you place the file name of your replacement image (jpg, png, and bmp image formats are supported) or color number or text. File names are relative to the .snap file, so image files must in the same directory or below the .snap file, and must include a file extension. Color numbers can only be used in elements that end in 'textcolor', and are written in hex. Eg: #AARRGGBB (Alpha Color, Red, Green, Blue with two digits for each) = #ffff0000 = Red with no transparency. The Color Picker in any decent image editing program will tell you the hex number for any particular RGB color you select although you may need to add the alpha color. Preview Images are not essential but can either be mocked up in photoshop (or gimp etc) or taken from a screenshot from your phone or captured using the Android SDK.

Once your skin is complete, place it in a zip file and transfer it to your phone to test. NAP can unzip files through the Options or Context Menu when browsing for Skin Files. Check each element is sized properly, and being loaded, and that it can successfully rotate back and forth between different screen orientations. Some text elements may not change color until the program restarts. Once you're satisfied with the Skin, email it to support@stellarworks.com.au with the subject 'NAP Skin' and it will be added to the Skin Page.

Quick Points to Remember:
  • Images can be jpg, png, or bmp.
  • You don't need to replace every skin element.
  • Color numbers can only be used in the tags ending in 'textcolor'.
  • File names are relative.
  • Colors are written in hex #AARRGGBB (Alpha Color, Red, Green, Blue with two digits for each).
  • Don't forget the hash in front of color numbers.
  • Be careful not to accidentally delete parts of tag names (eg </albumicon> becoming albumicon>).
  • Keep your image sizes small or make high definition versions of your skin.
  • Test your skin in different screen orientations.
  • The following tags must be present in the skin file: <napskin></napskin> (enclosing everything) <napskinversion>1.0 </napskinversion>, <name></name>, <author></author>, <description> </description>, <fileversion>1.0 </fileversion>, <previewimage></previewimage>


Chromecast
Chromecast is a Google device that plugs into your TV and runs specialized Apps that stream content to your TV over Wifi, while your mobile or tablet device acts as a remote control. NAP is one such specialized App that streams content FROM your mobile or tablet to your Chromecast device, while also acting as a remote control. This includes being able to stream Local Network, FTP and HTTP (NAP Pro Only) Songs to Chromecast, although these songs will be completely downloaded before playback begins (for this reason Preloading should be enabled in Streaming Options). NAP is able to do this by using an inbuilt HTTP server that runs on port 2100. This port must be added to any device firewalls. Chromecast is able to play mp3, m4a, ogg and wav files (flac is not supported by Chromecast).


Using NAP with Chromecast is incredibly simple, after setting up Chromecast, just look for the Chromecast Icon (see image above) in NAP's action bar and touch it. Once selected, NAP will launch it's App on Chromecast and begin streaming the current song to the device. All normal play/pause/seek etc controls will function, as well as any selected playlist modes such as Shuffle etc. The App will display Album Art and Album, Artist and Title information on your TV while running. The default Album Artwork is used if no Album Artwork is available. For this reason you may wish to ensure your songs contain embedded Album Artwork for a better visual experience.

Note: Chromecast requires Internet access to function because it retrieves its' Apps directly from the Google Play store.



Web Browser (NAP Pro Only)
NAP Pro includes a simple web browser with functions to make it easier to add and download all the songs on a webpage. After entering the desired URL in the Web Address textbox touch the 'Go' button in the Input Keyboard or touch the Access button next to it. A few moments after the webpage loads the Add Songs and Download Songs buttons will appear in the toolbar at the bottom of the screen. When used, these buttons will display a list with the number of songs found on the current page and the choice to add or download them all. However these functions only work with direct links to audio files with compatible file extensions and with webpages that display their contents in HTML (not through a client side scripting language like javascript).

Songs can also be added and downloaded (along with other file types) by touching their link in the web browser, including those exceptions noted above. The Web Browser can use your device's Mobile Data connection to access the internet if 'Allow Mobile Data Use' is enabled under Network/FTP/Streaming options. The Web Browser includes the following items in the option menu:
  • Search Webpage
  • Scroll to Top (Under Page Actions)
  • Scroll to Bottom (Under Page Actions)
  • Make Homepage (Under Page Actions)
  • Add Bookmark (Under Page Actions)
  • Download... (Under Page Actions)
  • Goto Homepage
  • User Entered History
  • Web Browser Options

Search Webpage shows a dialog box that allows you to enter simple keywords to search for on the current webpage.

Scroll to Top/Bottom scrolls the Web Browser to either the top or bottom of the current webpage.

Goto Homepage tells the Web Browser to view the current homepage URL. The default homepage is google.com.

Make Homepage makes the current webpage address the homepage.

Add Bookmark shows a dialog box with the current web page's title and address, ready to be added to a list of bookmarks. This list can be viewed by tapping the 'White Star' icon on the Web Browser's action bar. Long Touch each item to show a context menu with the option to remove the selected bookmark.

Download... will attempt to download the current web address to the user specified storage area. For webpages that don't have a filename, a timestamp will be used instead.

User History will show a list of the last 30 webpages the user has entered into the Web Address Textbox. This history can be deleted by going to Web Browser Options and using the 'Clear Browser History' button.

Web Browser Options shows an Activity with ability to edit the current homepage address and clear the Web Browser's history.



Playing Tab
This tab contains the Player Controls - previous, rewind, play/pause, fastforward, and next - as well as the current song's info - file name, artist, album, title and artwork (if it has any). As for Volume, it is controlled via your device's in-built volume controls when a song is playing. The options menu for this tab contains:
  • Volume
  • General Options
  • Equalizer
  • Visualizer
  • Open Skin (Under General Options)
  • About Skin (Under General Options)
  • Edit Tags (Under General Options)
  • Sleep Timer (Under General Options)
  • Repeat A and B/Repeat a Section (Under Repeat Options)
  • Repeat Entire Song (Under Repeat Options)
  • Help


Note: Turning on 'Repeat Entire Song' will remove 'Repeat A+B', as will moving the seek bar beyond the repeating section of the song.

Volume presents a slider which increases and decreases the App's volume level. This doesn't change the device's volume level.

General Options will display an activity that allows you to change the Audio Focus, Screen Orientation & State, Error Sound Effect, Interface Locking, D-Pad and Volume Controls.

Equalizer will display an activity that allows you to increase or decrease various sound frequencies. The Equalizer is only available on newer Android versions and only on supported devices.

Visualizer will show an activity with the currently selected type of visualizer. It is not available on all devices.

Edit Tags will display an activity with the current song's location, artist, album, genre, year and song title. These values are stored in NAP's database, and not stored in the source file.

Sleep Timer will show a list of available times to shutdown the player after the specified amount of time has passed. The countdown time begins when the option is selected or when the player starts.

Open Skin displays the file browser, allowing you to select a new compatible Skin file (files ending in the extension .snap). 'Long Clicking' on the skin file will display the context menu, and one of it's menu items is 'Skin Info'. Choosing this item will display the name, file version and a preview image of the selected skin. Should the skin be compressed inside a zip file, simply select the file and unzip it through the Options or Context menu. The resulting folder - with the same name as the zip file - will contain the skin file (.snap).

About Skin displays details about the current skin, such as it's file name and author, and allows you to restore the Default Skin.



General Options
The General Options activity contains the following fields:

Show Visualizer: When available, this option will show the specified type of visualizer in place of a song's album artwork.

Respect Audio Focus: This options controls how NAP will behave when another App Requests Audio Focus. When ticked, the default state, NAP will pause the current song when a Request is made. When it is unticked, NAP will ignore the Request and continue playing.

Screen Orientation: This option controls how NAP will orientate itself on screen. The first two options will lock the screen in either Landscape or Portrait mode, while the third option will keep NAP orientated the way it was when it first started. The fourth option, the default state, will change the orientation as the device is rotated.

Play Error Sound: Enabled by default, this option determines whether a sound effect will be played when an error occurs.

Use D-Pad Controls: When enabled, this option allows the audio player to be controlled using the hardware D-Pad on devices that feature one. This option will only function when the device's screen in on and the NAP interface has focus. This is a limitation of the Android operating system. The player controls are mapped as follows: Left and Right are Rewind and Fast Forward respectively, while Up and Down are Previous Song and Next Song respectively. The Select/OK button is Play/Pause.

Use LG Quick Button Controls: (Removed from KitKat Onwards) When enabled, this option allows the audio player to be controlled by using the Quick Button found on some LG brand devices. When using this option the button's action should be set to 'None' under your device's system settings. This option will only function when the device's screen in on and the NAP interface has focus. This is a limitation of the Android operating system. What action each button performs can be set using the accompanying combo boxes. To use the Hold function of each button, simply hold the button down for one second.

Use Volume Controls: When enabled, this options allows the audio player to be controlled using the hardware Volume Up and Down buttons. This option will only function when the device's screen in on and the NAP interface has focus. This is a limitation of the Android operating system. What action each button performs can be set using the accompanying combo boxes, but by default they act as follows: Pressing Volume Up Play/Pause, Pressing Volume Down Next Song, Holding Volume Up Increase Device Volume, Holding Volume Down Decrease Device Volume. To use the Hold function of each button, simply hold the button down for one second.

Keep Screen On / While Charging / While Headphones Plugged In: These options, when enabled, will prevent your device from turning it's screen off and locking, when the NAP interface has focus. This option is necessary for the D-Pad and Volume Controls to function effectively. It is disabled by default.

Allow Swipe to Change Song: When enabled this option allows you to change the current song by Swiping Left or Right while under the Playing tab. Swipe Left for the Previous Song, Right for the Next Song.

Allow Long Touch to Play/Pause Song: When enabled this option allows you to play or pause the current song, while under the Playing tab, by Touching and Holding the screen for half a second.

Allow Interface Locking: When enabled, this option will allow NAP to lock it's own interface and display a lock screen. It wont stop the Home key or Android Notification area from working. This function is activated by holding down the Back key for one second, and deactivated by doing the same thing or sliding across the lock dialog's seek bar. This option is useful when you're using the D-Pad or Volume Controls and want to place your device in your pocket. It is disabled by default.

Stop Playing Song When Closing: This option controls whether the current song is stopped when the Close NAP buttons (the X at the top of the screen, and the Close button in the Network Toolbar) are used, or whether the user is asked everytime.

NOTE: NAP now also supports Media Buttons, which are available on some devices. These buttons dont require the interface to have focus to function.



Playlist Tab
The Playlist tab contains a list of songs in the current playlist and a textbox for filtering the list. As of v3.1, it also contains a button for switching between different playlist Navigation modes: Song List (the old navigation mode), Year, Genre, Artist Mode, Artist Songs Mode, and Album Mode. The list displays the filenames for each song, which the textbox will filter against. Each song features a context menu which is displayed via a 'Long Click' (keep touching or selecting an item for a few moments). The context menu allows you to play, enqueue/dequeue songs, move songs around within the playlist (when in song list mode), and remove them. A circular progress bar indicates that the current playlist is being saved or altered. The options menu for this tab contains:
  • Add Local Song(s)
  • New Playlist
  • Open Playlist
  • Save Playlist
  • Playlist Options (under Playlist Options)
  • Streaming Options (Under Streaming Options)
  • Change Streaming Logins (Under Streaming Options)
  • Change Streaming Address (Under Streaming Options)

Add Local Song(s): As explained previously displays the File Browser activity, and allows you to add songs to the existing playlist.

New Playlist clears the existing playlist, and 'Open Playlist' restores a previously saved playlist along with it's Playlist Mode (replacing the existing playlist) - chosen via the File Browser activity.

Save Playlist saves the current playlist along with it's Playlist Mode to the file specified by the File Browser activity.

Playlist Options displays an activity with options to control playlist behavior - use tags in playlist, playlist mode, and selection mode.

Streaming Options displays an activity with options to control Streaming behaviour - Change the default cache location, Permanently Save Streams, and set the Buffer size.

Change Streaming Logins displays a dialog box that allows you to change the playlist's embedded logins details, stored against each streaming song. These details are encrypted when stored.

Change Streaming Address displays a dialog box that enables you to change the playlist's streaming network addresses on mass. This is useful if a computer changes it's IP address.

Note: The File Browser will filter the files displayed to compatible playlist files, for both Open and Save Playlist. In 'Save Playlist' mode it will display a filename textbox where you can enter a name for the particular playlist. If this name already exists in the selected directory, that file will be overwritten.



Playlist Options
The Playlist Options activity contains the following fields:

Use Tags in Playlist will display a song's Artist and Title tags in the playlist, instead of its' file name.

Song List Alphabetical will order the songs in Song List navigation mode by alphabetical order.

Playlist Mode controls how the App selects the next song when the current song finishes playing. Shuffle will randomly select a song from either: the entire Playlist, the current Artist, the current Album, the current Genre or the current Year. Repeat will loop the around to beginning of the Playlist when it reaches the end of either: the entire Playlist, the current Artist, the current Album, the current Year or the current Genre. No Repeat will stop playing when the the App reaches the last song in the entire Playlist, the current Artist, the current Albumm, the current Year or the current Genre.

Multi Select allows you to select multiple items in the playlist and enqueue, remove or move them.

Single Select returns the selection method to the default of one item only.



Streaming Options
The Streaming Options activity contains the following fields:

Browse Cache Locations: This options sets the location where streaming songs will be temporarily stored. The File Browser will be launched when the button is pressed, allowing you to navigate to the desired storage location, which must be writeable.

Permanently Save Streaming Files: When this option is used, streaming songs will be stored permanently at the specified location, instead of being stored temporarily.

Browse Save Locations: This option sets the location where streaming songs will be stored permanently, when that option is enabled. The File Browser will be launched when the button is pressed, allowing you to navigate to the desired storage location, which must be writeable.

Cache Size: This field sets the maximum cache size when streaming songs. When the number of cached songs reaches this value, the oldest song is removed from the cache. The default value is 5. This field will have no effect when the Permanently Save Streaming Files option is enabled.

Delete Cache on Exit: This option will remove any cached streaming files when the App exits, except those permanently saved.

Allow Mobile Data Use for FTP: This option, disabled by default, allows NAP to use your device's mobile connection to access the internet when using FTP. The 'Data enabled' option must also be enabled under your device's Mobile Network settings for this to occur. This is the same option as the one under FTP Options.

Reload on Download Completion: This option makes the current Streaming Song buffer/reload when the song finishes downloading. This may cause a slight pause, if the song is currently playing. If this option is not enabled, the seek bar will not be available while the song is playing. It is enabled by default.

Complete Download Before Playing: This option makes a Streaming Song buffer in it's entirety before beginning to play. The song will not buffer during play and the seek bar will be available as soon as the song begins to play.

Preload Next Song - If it's Streaming: This option will make the App download the next song in the current playlist, if it's a streaming song, as soon as the current song finishes downloading. This option will not work with Shuffle mode, as the next song is only chosen after the current song finishes playing. This option is enabled by default.

Send HTTP URLs Directly to Chromecast (No Logins): This option is only available in NAP Pro, which features HTTP Streaming. It causes the App to send URLs directly to Chromecast to download, instead of downloading that URL itself and then sending it to Chromecast. Using this option allows for faster playback of HTTP URLs because Chromecast can playback the file as it downloads. However it can't do URLs that use a login.

Buffer Size: This drop down box sets the buffer size used for Streaming Song. It affects how long a Streaming Song will play for, before needing to buffer again, depending on the current song bit rate and current download speed. It is ignored when the Complete Download Before Playing option is enabled and partially ignored for m4a songs, which require larger starting buffers.

When Adding Streaming Files: This collection of options controls how NAP retrieves tags from network songs. When a network song is added to the playlist, and this option is enabled, NAP will download a portion of the file and attempt to read it's song tags. The 'Download File Tags with Cache' option will store the tags retrieved in a database, and reuse them if the streaming song is added again in the future (faster). The 'Always Download Fresh File Tags' option will never reuse old tags and always download the file to retrieve new tags (more accurate). The 'Download File's First' option controls how much of the network song is downloaded before the App attempts to retrieve its' tags. The bigger the size, the more likely it is to succeed, but the longer it takes to add files. Several of these options are also available for Sync Network Folders.



Network Tab
The Network Tab contains a textbox for entering the IP Address/Name of a computer and a button for either accessing that computer or discovering the local network. After pressing this button a list will be displayed below it, containing network folders, files (possibly filtered to compatible song types), workgroups and computers. The Network Tab also has a toolbar for medium/large screen devices that allows you: Exit the App, Show Network Favourites, Add Network Songs, and disconnect from FTP sites. The options menu for this tab contains:
  • Network Favourites (Under Favourites & Synced Folders)
  • Add Folder to Favourites (Under Favourites & Synced Folders)
  • Sync Network Folders (Under Favourites & Synced Folders)
  • Add Folder to Sync Folders (Under Favourites & Synced Folders)
  • Show Transfers
  • Download (Under File Actions)
  • Add to Playlist (Under File Actions)
  • File Info (Under File Actions)
  • Rename (Under File Actions)
  • Delete (Under File Actions)
  • Refresh (Under File Actions)
  • Transfer Mode (Under Network Options) (NAP Pro Only)
  • FTP Disconnect (Under Network Options)
  • FTP Options (Under Network Options)
  • LAN Options (Under Network Options)
  • Change Login (Under Network Options)
  • Song Filter (Under Network Options)
  • Long Touch Mode (Under Network Options)
  • Select Default Download... (Under Network Options)
  • About

Network Favourites presents an activity containing saved Network folder, which contain the address and login details for network computers for convenient access. Previously created Network Favourites can be selected via the displayed list. New Favourites can be created by using the 'Add' buttons and existing ones altered by using 'Edit' or Remove' items in the context menu.

Add Folder to Favourites creates a new Network Favourite with the current server address and login details.

Sync Network Folders shows an Activity containing saved Sync Folders, which hold the scheduled time, mode, remote address, local directory, and login details of each Synchronization Folder. Previously created Sync Folder can be selected via displayed list and executed via the 'Run' item in the context menu. New Sync Folders can be created by using the 'Add'' button and existing ones altered by the 'Edit' or 'Remove' items in the context menu.

Add Folder to Sync Folders creates a new Sync Folder with the current server address, directory and login details.

Show Transfers displays the File Transfers Activity and is only available when there are downloads current or pending.

Download is only shown when a network file or folder is selected.

Add Selected to Playlist/Add All to Playlist/Add All Songs to Playlist add the current network directory's files and folders, depending on the respective item, to the current playlist.

File Info is only displayed when a network file or folder is selected. It shows the file size and modification date of the selected file.

Rename is only displayed when a network file or folder is selected. It allows you to rename the selected file or folder via a dialog box, if the current user has the permission level to do so.

Delete is only displayed when one or more network files or folders are selected. It allows you to delete remote files and folders, if the current user has the permission level to do so. Depending on the directory size, this may take some time.

Refresh updates the current directory by retrieving it's contents again.

Transfer Mode is an option in NAP Pro that controls whether existing download files are overwritten or resumed.

FTP Disconnect terminates the current FTP connection.

FTP Options presents an activity where the FTP Transfer Type, Keep Alive, Passive Connection, and Allow Mobile Data Use options can be set.

LAN Options presents an activity where the LAN Authentication Mode can be changed. You may need to set this option to match the Authentication mode supported by your Local Network Device.

About presents the About Dialog box, which contains the Application version number and contact email.



Network Options
The Network Options activity contains the following fields:

Show Only Song Files controls whether all remote files are displayed or just compatible song files.

Long Touch Navigation when this item is checked, folder navigation will require a Long Touch (keep pressing down) instead of a Single Touch.

Allow Mobile Data Use, disabled by default, allows NAP to use your device's mobile connection to access the internet. The 'Data enabled' option must also be enabled under your device's Mobile Network settings for this to occur. This is the same option as the one under FTP and Streaming Options.

Selection Mode allows the user to select one item or many items in the network files list.

Default Download Location displays the File Browser so a folder can be selected that will be used with the 'Download to Default' file action.



FTP Options
The FTP Options activity contains the following fields:

Allow Mobile Data Use: This option, disabled by default, allows NAP to use your device's mobile connection to access the internet when using FTP. The 'Data enabled' option must also be enabled under your device's Mobile Network settings for this to occur. This is the same option as the one under Streaming Options.

Keep Alive: When enabled, this option will keep FTP connections active by sending periodic No Operation commands. It is disabled by default.

Passive Connection: This option, enabled by default, changes the mechanism used when connecting to an FTP server. Passive Connections work behind firewalls and NAT routers that dont allow connections to be made from outside the network. If this option is disabled, an Active Connection will be used instead, which may not work behind firewalls or NAT routers.

Transfer Type: This option, Auto by default, changes the way FTP downloads are processed. When Textual is selected, downloaded data is treated like it was ASCII text, while Binary performs no extra interpretation. Auto will select the most appropriate transfer type for each file.




Synchronizing Network Folders
The Synchronize function introduced in v3.0 enables NAP to automatically download and/or add songs in network folders to the current playlist. Both Local Network shared folders and FTP folders are supported and syncing can be scheduled to run at any time of the day and any day of the week. This feature can be accessed by going to the Options Menu under the Network Tab, and selecting 'Favourites & Sync Folder' followed by 'Sync Network Folders'. Doing so will display an activity containing options to Add, Remove, Save and Edit Synchronization Profiles. Each Synchronization Profile can access a different remote folder, store files in different local folders, and be scheduled to run at different times and intervals. Each time a Synchronization Profile is run, it's status is updated, which can be viewed by going to Sync Network Folders and selecting Status from the context menu.

It is important to note that when a Synchronization Profile runs, it will wake up the device if it is sleeping and reconnect to the local Wifi Network, before shutting down again. This means it will be consuming battery life while it executes. This shouldn't take long when the Synchronization Mode is 'Add to Current Playlist' but if the mode is 'Download & Add to Current Playlist' then it could take hours if it's the first time it's run or if the remote folder has changed a lot. Unexpected battery loss can be avoided by scheduling the syncing to occur when you usually charge your device.

When editing Sync Folders there several options that are specific to using FTP. One of these is 'Allow Mobile Data Use', which enables NAP to access an FTP server using a Mobile Data Connection. It is important to know that using a Mobile Connection in this fashion can in occur significant charges from your phone carrier. FTP folders can contain hundreds of files so the program could likewise download hundreds of megabytes of data. This option is also subservient to the 'Allow Mobile Data Use' under the FTP Options item in the Network Options menu. Which means that if the FTP Options doesn't allow Mobile Data Use, neither will Synchronization. Regardless, if an active Wifi connection is available, that will be used instead.

Another thing to note with FTP is that Remote Address and Remote Directory are separate textboxes, while with LAN there is just one textbox for Remote Address. This is because with FTP you need to make a distinction between the root address and the directory you are trying to access, because of user permissions. FTP addresses should be written with the Remote Address pointing to your home directory eg: ftp.mydomain.com/myhomefolder . And the Remote Directory, if there is one, pointing to /mysubfolder/. LAN Addresses on the other hand should be written as usual eg: smb://mycomputer/subdirectory/ .

Version 3.3 added the option to Download Tags to Synchronizing Network Folders. This option is useful when using the 'Add to Current Playlist' mode, as it retrieves the song's tags so they can be displayed in the current playlist. The 'Download with Cache' option stores these tags so they don't have to be retrieved everytime the Sync process runs (faster). While the 'Always Download' option allows the tags in the current playlist to be kept in sync with the tags in network files (more accurate), without having to alter the current playlist in any other way.



Widget
NAP includes a Widget so the audio player can be controlled from the Home screen. The Widget can play/pause, move to the next and previous songs, as well as display the current song's filename and artist & title. This Widget interacts with NAP's background service - which controls songs and playlists - if this service is not already running there may by a gap of a few seconds between your interaction and a response.


How to Add a Widget
The exact method of adding a Widget depends on your version of Android, but generally you perform a 'Long Click' on the background of the Home screen. This displays a menu where you can select 'Widgets'. Picking this menu item displays the list of available widgets - NAP being one of them.



Troubleshooting & FAQ

So whats in NAP Pro?
Download resuming, downloading without the interface running, HTTP/Web Streaming/Downloading and a Web Browser to make it easier to add songs to a playlist. It's also Ad Free!


How Do I Switch Between Overwriting or Resuming Downloads in NAP Pro?
Bring up the options menu under the Network Tab and go to Network Options -> Transfer Mode. Or use the Shortcut menu item in the Activity Bar (looks like a cog) and select Transfer Mode.


How Do I Open the Web Browser in NAP Pro?
Touch the icon on the left side of the Network Tab's Address Textbox and select HTTP/Web from the list displayed. Or bring up the options menu and select Open Browser -> Web Browser.


Why Can't I Save Files to the SD Card (on Android KitKit and beyond)?
With the release of KitKat, Google changed it's storage policies and stopped allowing Apps to write anywhere they want on SD Cards. A baffling decision. Restoring full access to the SD Card can only be done by acquiring root permissions for your device and editing a system file. If you're game, instructions on how to do this can be found on the internet for most devices.


How Do I Change to Artist / Genre / Year / Song List Playlist Navigation?
Select the Playlist tab and touch the icon to left of the Filter Playlist textbox. This will show a list of the available navigation modes, or switch between Artist Albums/Artist Songs when viewing an Artist.


What are the Available Navigation Modes?
Song List/Song List Alphabetical, Genre, Year, Artist, Artist Songs, Artist Albums/Album Songs. Song List Alphabetical is enabled through Playlist Options. Song List is the old playlist navigation mode and lists songs in the order they were added.


What are the icons for each Navigation Mode?
Song List/Song List Alphabetical Mode:


Artist Mode:


Genre Mode:


Year Mode:


Artist Songs:


Album/Album Songs:



Why does Adding Network Songs take longer than it use too?
Version 3.3 added a feature that downloads a portion of a file and tries to retrieve song tags to display in the current playlist. This takes some time to do, and can be turned off under Streaming Options.


How do I Change Between the FTP and Local Area Network modes?
Touching the icon on the left side of the Network Tab's Address Textbox will show a list with items for LAN, FTP and HTTP/Web (NAP Pro Only). Selecting the option you want from the list will display a picture with a Globe when in FTP Mode, and a picture with Two Connected Computers when in LAN Mode. HTTP/Web will launch the NAP Web Browser Activity.

I Keep Getting 'Login authentication failed' When I try to Connect to a LAN Device
If you're sure you're using the right username/password and that your network shares are setup correctly with the right permissions (have you tried guest access?), you may need to change the LAN Authentication Mode. This option can be set by bringing up the Options menu under the Network Tab and going to Network Options, LAN Options. It controls how NAP's LAN client communicates with network devices and can only be set for all LAN connections and requires the App to restart when it changes. If you dont know which option to select, try each one starting from '0 - LM & NTLM' (which works with old file sharing versions). This webage for Microsoft Windows explains each value in more detail. Window's LAN Authentication mode can also be changed by using regedit and editing/adding the LmCompatibilityLevel variable, as detailed in the same webpage.


What Happened to Support for Old Android Versions?
Adding Chromecast support meant dropping support for Android versions older than v2.3. However NAP v3.1 is still available for those devices.


How Do I Change the Volume?
While a song is playing use your device's inbuilt volume controls. Alternatively you can alter the App's own volume level through the options menu or onscreen controls for large screens.


Folder Navigation Used to be Long Touch.
Folder Navigation was changed to Single Touch in v2.05 because some users requested it. Long Touch navigation can still be used by ticking the 'Long Touch Mode' item in the Network Options activity, under the Network Tab options menu.


Synchronization says 'Internet/Wifi Unavailable' after running.
Synchronization can run when your device is sleeping, and disconnected from the local network or when you are travelling, so this error may occur from time to time. When a Sync Profile is scheduled to run, NAP will wake up your device and attempt to reconnect to the local network, but it may not succeed for any number of reasons. Also FTP Syncing can use a Mobile Data Connection to operate but it will only do so when both the Synchronization Profile and FTP Options/Streaming Options allow it.


FTP & Internet Access
The FTP client can operate over a Wifi connection with internet access or over a Mobile Data Connection. However it will only operate over a Mobile Data Connection when the 'Allow Mobile Data Use' option is checked under either the FTP Options or Streaming Options menu. They are both the same option, and override any selected options in a Synchronization Profile. This is done because using a Mobile Data Connection can in occur significant charges from a phone carrier.


Why do .flac files take longer to Buffer than other files?
Flac files have to be completely downloaded before they can play.


How do I change the Buffer Size?
Bring up the Options menu under the Playlist tab, and press the More button (if needed) to display the 'Streaming Options' item. Selecting this item will display a dialog box that allows you to select a buffer size ranging from 75KB to 500KB.


How are the Player Controls mapped for D-Pad Controls?
Left and Right are Rewind and Fast Forward respectively, while Up and Down are Previous Song and Next Song respectively. The Select/OK button is Play/Pause.


Why do songs keep pausing when I launch another App?
NAP respects Audio Focus by default. This means that when another App wants to be the only program to play audio, NAP will pause the current song. If you don't want this to happen, go to General Options under the Playing tab and untick 'Respect Audio Focus'.


I downloaded a directory but only the audio files were downloaded. What gives?
You have the Song Filter turned on. To turn it off, go to the Network Options menu, under the Network tab. However if you mean Synchronization, it will only ever download compatible songs.


Balance Control Does Nothing
On Android you can set a Media Player's Left & Right speaker volume separately. On some devices this feature is broken and all channels play at 100% volume. So it's up to your device manufacturer to fix.


Where can I find Skins?
Visit this webpage and download a skin with your device's browser or transfer it to your device from your computer. Then goto to the Skin Options menu under the General Options menu and Open a New Skin. Unzip the file using NAP's inbuilt function and navigate to the resulting folder and select the '.snap' file.


How Many Songs can I add to the Playlist?
There is no maximum limit, although NAP has been tested with up to 10,000 songs. When loading a large number of songs the interface may freeze, and Android may think the program has stopped responding. If this occurs, press the 'Wait' button in the Android dialog box.


Unknown Song Tags.
The audio file is either missing the information (no album art, artist name etc) or the file has not yet been scanned by the Android Media Scanner. This application is responsible for retrieving audio tags from mp3 files and the like. Restarting the mobile device will often correct this particular issue.


How do I Setup File Sharing?
A quick google will provide the answer to this question, but here are a few starting points: Windows XP Sharing and Windows 7 Sharing.


How do I get my Computer's Network Address?
A Windows computer has two network addresses - it's NetBios Name and it's IP Address. To get it's NetBios name right click on Computer on the Desktop and click 'Properties'. It's name will be displayed under 'Computer name, domain, workgroup'. To get it's IP address bring up the Start Menu and type 'cmd' into the 'Search programs and files' textbox. This should bring up a black dialog box with a prompt like 'C:\Users\SomeUser>'. Type 'ipconfig' or 'ipconfig/all' into the dialog box. This should display a bunch of information about your computer's network connections. Look for the heading 'Ethernet adapter Local Area Connection' or 'Wireless adapter Local Area Connection'. Under these headings there should be a field labelled 'IPv4 Address'. The value across from this is your computer's current LAN IP address. It may change over time, and is different to your internet IP address.


Access Denied for Local Folder.
Many of the directories above the primary storage directory are restricted, and can only be read or altered with superuser permissions which this App does not have.


The handle is invalid.
This Networking error mostly likely relates to the connection timing out during an operation. Try the operation again, and check the network folder is accessible from another computer. Also try using an IP address instead of a computer name. If the problem persists, the folder you are trying to browse may be too large to view for the program's current connection timeout value. In version 2.05 this value is 11 seconds. Should this value prove insufficient please contact support@stellarworks.com.au so adjustments can be made for future versions.
Stellarworks® 2011-15