View source

From SqueezeboxWiki

You do not have permission to edit this page, for the following reason:

You can view and copy the source of this page:

== [[SlimServer]] (6.5.1) Specification == This document is describes the [[SlimServer]] application and its behavior at the current release version, 6.5.1. Please do not use this document for feature requests. [http://bugs.slimdevices.com File a bug], and give it a priority of "enhancement". Proposed changes for the next version of Slimserver are available as part of a separate document ([[SlimServer7Spec]]). When the next version is released, the changes will be integrated. # '''Overview'''<nowiki>: In general, Slimserver is a software application which runs on an end-user's PC. It scans music files also stored on the PC, and stores information about the music files in a database. It uses the information in the database to present a user interface including information about the tracks as well managing playlists. Slimserver presents an http server on port 9000 which is accessible from the PC or from other web devices on the local network. In addition, it maintains a two-way connection with SMS hardware devices using the 'Slim Protocol' or slimproto, which is carried as TCP/IP network traffic. Slimserver does not need to be aware of how the traffic is transported, specifically. Music can be streamed to the devices for playback as well as images for the player display. Information received by the IR reciever on the device or from the controls on its front panel is passed back across the network for Slimserver to interpret.</nowiki> # Web Interface ## Browse Music ### Browse Genres ### Browse Artists ### Browse Albums ### Cover art ## Skins ### Each skin needs to be tested for some set of basic UI functionality #### Can get to Player Settings #### Can get to Server Settings #### Can perform playlist functions ##### Loading ##### Adding ##### Removing ##### Moving ##### Save ##### Clear ##### Play #### Can perform browsing functions ##### By Album ##### By Artist ### Bagpuss ### Dark ### Default ### Light ### [[ExBrowse3]] ### Fishbone ### Handheld ### Touch ### Moser ### Nokia770 ### Purple ## Settings ### Player Settings #### /Need to enumerate all the pages and all the settings/ #### Need to verify all settings are getting written to the prefs, and all prefs are being read in correctly. #### Basic ##### Player Name ##### Title Format ##### Now Playing Information ##### Screensavers ##### Forget Player ##### Player Information ##### Version Info #### Alarm ##### Fade alarms in ##### Each alarm time works #### Audio ##### Power on Resume ##### Turn off Audio ##### Crossfade ##### Crossfade duration ##### Digital Volume Control ##### Preamp volume control ##### Audio startup time ##### [[Bitrate limiting]] ##### Volume Adjustment/Replay Gain ##### MP3 Streaming method #### Menus ##### Home Menu ###### All options are listed: ####### Now Playing ####### Browse ####### Search ####### Random Mix ####### Favorites ####### Playlists ####### Internet Radio ####### Settings ####### Plugins ####### [[SqueezeNetwork]] ###### They can be removed and moved successfully ###### Removed items appear in the inactive list ###### Inactive items can be added to the main list ####### Albums ####### Artists ####### Games ####### Genres ####### Music Folder ####### New Music ####### Screensavers ####### Search for Albums ####### Search for Artists ####### Search for Songs ####### Songs ####### Years ###### Plugins can be added to the main list ####### Date and Time Screensaver ####### Live Music Archive ####### Live365 Internet Radio ####### Network Test ####### Podcasts ####### RSS News Ticker ####### [[RadioTime]] ####### Rescan Music Library ####### [[SHOUTcast]] Internet Radio ####### Save Playlist ####### Slim Devices Picks ####### [[SlimTris]] ####### Snow Screensaver ####### Visualizer Screensaver ####### radioio.com - no boundaries #### Display ##### Brightness ###### Brightness when on ###### Brightness when off ###### Brightness when idle ###### Automatic Display Brightness ##### Font ###### All selected items appear on the device in the selected order ###### light, high, standard, threeline, and full are selectable ##### Standby Font ###### All selected items appear on the device in the selected order ###### light, high, standard, threeline, and full are selectable ##### Scroll Mode ###### Standard scrolling ###### Scroll once and stop ###### Do not scroll ##### Scroll Pause ###### Single line (in seconds) ###### Double-Size (in seconds) (wtf does this do?) ##### Scroll Rate ###### Single line (in seconds) ###### Double-Size (in seconds) ##### Scroll Pixels ###### Single Line Scroll Pixels ###### Double-Size Scroll Pixels #### Remote ##### Slimdevices Remote ##### JVC Remote ### Server Settings #### /Need to enumerate all the pages and all the settings/ #### Basic Settings ##### '''Language:''' Selects the web and player interface language. Localized strings are stored in /[[SlimServer]]/server/strings.txt. ##### '''Music Folder:''' Specifies the top-level directory under which Slimserver scans for music. All subfolders should be scanned. ##### '''Playlists Folder:''' Specifies the top-level directory under which Slimserver scans for playlist files. All subfolders should be scanned. ##### '''iTunes:''' Enables or disables a set of behaviors to ease use of Slimserver with iTunes. The behaviors include: ###### Scanning the iTunes Music Library.xml file for tracks, track info, and playlists. ##### '''Rescan Music Library:''' Triggers a rescan of the user's music and playlists folder. There are three options and a 'Rescan' button. All rescan operations will take place 'in the background' and do not block the server's operation. ###### Look for new and changed music. This mode will leave all existing information present within the database and only check for files whose timestamp has changed, or which are not known in the database. If a timestamp on a file has changed from that in the database (including if it no longer exists on the filesystem) its database entry will be replaced with that of the details from the filing system. If new files are added to the filesystem they will be added to the database. ((the filing system covers, eg 'folder.jpg', details may not be updated by this method; is this a fault or a design ?)) ###### Clear library and rescan everything. This mode will first remove all information from the database (no changes are made to the playlists or the user's configuration) before searching the filing system for files as with the above option. ###### Only rescan playlists. This mode only looks for new and changed playlists. Any playlist which was added or modified outside of the server will be updated by this scan. ##### Version Info section: ###### The Slimserver version is inserted into the application at build time. ###### The Perl version Slimserver believes it is running on ###### The [[MySQL]] version ###### The IP address Slimserver believes it is serving from is displayed here. #### Behavior ##### '''Play other songs in album:''' When you select a single song and press PLAY, while browsing albums or folders, you can choose to play just that song or all the songs in that album or directory, starting with that song. #### Debugging #### File Types #### Formatting #### Interface #### iTunes #### Network #### Performance #### Plugins #### Internet Radio #### Security ## Current Playlist ## Transport Controls ## Internet Radio ### Tune-in URL ### Live365 ### Live Music Archive ## Help ## XML interface ## JSON interface ## [[TelCanto]] Support # General UI Principles ## Songs should be sorted by title, artist, album, and track num. In cases where a user has added a group of songs to a list, the sorting of songs as they go into the playlist should be the same as you browse them (i.e. If you add a whole artist, the songs should be sorted first by the album, then by the song number). /See bug(s) 4466./ # Player UI ## See also [[UserInterfaceGuidelines]] ## Behaviors ### Browsing to 'Browse -> Artists' or other top-level browse heading and hitting 'play' should not play anything due to the fact that it's likely to be an erroneous button press. /See bug(s) 4572./ ### Browsing to the title of a specific track and pressing 'play' should play that track according to the Server Settings -> Behavior selected. /See bug(s) 4421./ ## IR/Button Input ### Remote Control #### '''Supported IR Code Sets:''' Both the JVC DVD and Slim Devices Remote code sets are supported. They can be enabled and disabled on a per-player basis on the Player settings -> Remote page. #### '''Number buttons in sorted lists:''' "Sorted lists" are those that are sorted alphabetically and should use the number keys as on a phone (i.e. press 2 to jump to the first item that starts with a 'B'). All others should use the number keys as numbers: press 1 to jump to the first item, 0 to jump to the last, and the other digits to jump proportionally within the list. This behavior should be encapsulated in the INPUT.list mode. /See bug(s) 4437./ ### Front Panel Controls #### Knob #### Buttons ## Player Display Output ### Fonts #### Unicode/[[TrueType]] #### Player-specific fonts ### Home Menu ### Visualizers/VU Meters ### Power Off #### Clock ### Alarm Clock ### Volume Control ### Browse Music #### Browse Genres #### Browse Artists #### Browse Albums #### Browse Playlists ### Favorites ### Settings ### Song Info ### Station Info ### Synchronization ### Screensavers #### Now Playing #### Now Playing (Jump Back On Wake) #### Clock ## Player Specific Functions ### SLIMP3 ### Squeezebox1 ### Squeezebox2/3 ### Transporter #### Knob #### Front Panel #### Digital Inputs ### [[SoftSqueeze]] # Audio ## Streamed from files ### Supported file formats #### MP3 - Audio MPEG 1, 2 and 2.5, layer I, II and III. ((need to confirm that layer I is supported; ISTR seeing something about the decoder chip not supporting it, possibly on [[SliMP3s]] only)). #### FLAC #### WMA ##### WMA Lossless ##### WMA Voice ##### WMA #### AIFF #### WAV #### Ogg Vorbis #### AAC #### [[QuickTime]] Movies #### Apple Lossless #### Apple Music Store #### Shorten #### Monkey's Audio #### Musepack ## Internet Radio ### Icecast/Shoutcast HTTP streaming ### Ogg Vorbis ### WMA #### WMA MMS #### WMA via HTTP ### Podcasts ### Slim Devices Picks ### [[RadioIO]] ### [[ShoutCast]] ## Other Sources ### Rhapsody ### [[UPnP]] ## Awareness of Player-Implemented Codecs ### Transcoding ## Shoutcast/Icecast streaming (i.e. stream.mp3) # Playlists ## Formats ### ASX - MSDN document appears to be a good starting point - http://msdn2.microsoft.com/en-us/library/aa386633.aspx ### CUE - as specified at http://wyday.com/cuesharp/specification.html ### PLS - no official format seems to exist, although http://forums.winamp.com/showthread.php?threadid=65772 seems to be reasonable given its lineage ### M3U - no official format seems to exist, although http://forums.winamp.com/showthread.php?threadid=65772 seems to be reasonable given its lineage ### WPL - ((cannot find a proper specification on the MSDN site)) ### XML - ((don't know what this is; XML is an data transfer format, rather than a specification of playlists)) ### XSPF - as specified at http://www.xspf.org/xspf-v1.html # Database ## Scanner ### File System #### Album Art ### iTunes ### [[MoodLogic]] ### Music Magic ## Compilation/Various Artists Albums ## Best of Albums ## Tags ### Tag sources #### MP3 ##### [[ID3v1]] - as specified at http://www.id3.org/id3v1.html ###### Title field (30 chars) is processed as the TITLE tag. ###### Artist field (30 chars) is processed as the ARTIST tag. ###### Album field (30 chars) is processed as the ALBUM tag. ###### Year field (30 chars) is processed as the YEAR tag. ###### Track number (1 byte) is processed as the TRACKNUM tag, but only if the comment field is terminated at character 28. ###### Comment field (28 chars if track present, 30 chars otherwise) is processed as the COMMENT tag. ###### All strings are presumed to be ISO-8859-1, although a 'guess' is made as to other encodings. ###### Trailing nuls will be stripped from the strings; other embedded data may be retained (eg 'name<nul>junk<nul><nul>' would be processed as 'name<nul>junk'). ##### [[ID3v2]] - as specified at http://www.id3.org/develop.html ###### [[ID3v2]].2 is processed. ###### [[ID3v2]].3 is processed. ###### [[ID3v2]].4 is processed. ###### [[ID3v2]].4 footers are processed. ###### Embedded (inline with stream) [[ID3v2]] tags are not processed - only headers and footers are processed. ###### [[ID3v2]].4 headers inset by a short amount (junk at start of file) are processed (include size that will be searched?) ###### TSOA frames are processed as the ALBUMSORT tag. ###### TSOP frames are processed as the ARTISTSORT tag. ###### XSOP frames (compatibility with other clients? not in [[ID3v2]] specification) are processed as the ARTISTSORT tag. ###### TSOT frames are processed as the TITLESORT tag. ###### TP1/TPE1 frames are processed as the ARTIST tag. ###### TCM/TCOM frames are processed as the COMPOSER tag. ###### TP2/TPE2 frames are processed as the BAND tag. This is per the ID3 spec. However, note that iTunes uses the BAND tag as 'Album Artist'. ###### TP3/TPE3 frames are processed as the CONDUCTOR tag. ###### PIC/APIC frames are processed as the PIC tag. ####### Only the first picture in the tag will be processed; others are ignored. The format, picture type and description are ignored. ###### TBP/TBPM frames are processed as the BPM tag. ###### RVA/RVAD/RVA2 frames are processed as the REPLAYGAIN_TRACK_GAIN and REPLAYGAIN_TRACK_PEAK tags. ###### ULT/USLT frames are processed as the LYRICS tag. ###### TCP/TCMP frames (compatibility with iTunes, not in the [[ID3v2]] specification) are processed as the COMPILATION tag. ###### TT2/TIT2 frames are processed as the TITLE tag. ###### TAL/TALB frames are processed as the ALBUM tag. ###### TYE/TYER frames are processed as the YEAR tag. ###### TDRC frames are processed as the YEAR tag (though they may contain more accurate information than just a year). ###### TCON frames are processed as the GENRE tag. ####### Bracketed number genres are processed into their textual equivalent. ####### Bracketed number genres with refinements (subsequent textual description) will be processed but the refinement will be used as the genre name (numeric genre discarded). ###### COM/COMM frames are processed as the COMMENT tag. ####### R.River Media centre comments (with the text 'Media Jukebox') are processed as TXXX frames, for compatibility. ###### TXX/TXXX frames are ??? (not sure of processing) ###### TRK/TRCK frames are processed as the TRACKNUM tag. ###### TPA/TPOS frames are processed as the SET tag. ###### Textual data in [[ID3v2]].4 tags may contain multiple entries per tag, separated by a nul. These will be converted into multiple entries (an array) before being passed back. For example, [[ID3v2]].4 TIT1 tag with the content 'this<nul>that' will be processed as two TITLE tags with the content 'this' and 'that'. ###### Textual data may be encoded in ISO-8859-1. ###### Textual data may be encoded in UTF-16. Textual data in [[ID3v2]].2 and [[ID3v2]].3 tags encoded with UCS-2 will be treated as if they were UTF-16 (distinction is only in the lack of surrogate support in UCS-2 so should not be significant). ###### Textual data may be encoded in UTF-16BE. ###### Textual data may be encoded in UTF-8. ###### Compressed frames are not supported. ###### Encrypted frames are not supported. ###### Unterminated text strings are supported ([[ID3v2]] requires that text strings end in a terminating nul; to support non-complaint encoders unterminated strings are supported. ###### iTunes-style [[ID3v2]].4 tags are supported by heuristics. iTunes writes [[ID3v2]].4 header data, with frame lengths encoded using [[ID3v2]].3 rules. We support iTunes style broken frames by checking for the length being invalid under [[ID3v2]].4 rules and reverting to [[ID3v2]].3 rules. ##### APE - as specified at http://wiki.hydrogenaudio.org/index.php?title=APEv2_specification ((need to confirm this is the official definition)) ###### TRACK tags are processed as the TRACKNUM tag. ###### DATE tags are processed as the YEAR tag. ###### DISCNUMBER tags are processed as the DISC tag. ###### /add details of APE tag mappings/ ###### If no TITLE tag exists then all APE tag details are ignored. #### WAV ##### [[ID3v2]] (and v1?) (see entry under MP3) #### AIFF ##### [[ID3v2]] (and v1?) (see entry under MP3) ##### '''COMMENT chunk:''' gets searched for iTunes normalisation, used as REPLAYGAIN_TRACK_GAIN. #### Ogg - as specified at http://xiph.org/vorbis/doc/v-comment.html ##### TRACKNUMBER tags are processed as the TRACKNUM tag. ##### DISCNUMBER tags are processed as the DISC tag. ##### /other tags?/ #### Musepack - http://trac.musepack.net/trac/wiki/SV8Specification (is this right?) ##### TRACK tags are processed as the TRACKNUM tag. ##### DATE tags are processed as the YEAR tag. ##### DISCNUMBER tags are processed as the DISC tag. ##### /add details of other Musepack mappings/ ##### If no TITLE tag exists then all Musepack mappings are ignored. #### FLAC - as specified at http://xiph.org/vorbis/doc/v-comment.html (ie Ogg comments) ##### TRACKNUMBER tags are processed as the TRACKNUM tag. ##### DISCNUMBER tags are processed as the DISC tag. ##### COVERART tags are processed as the ARTWORK tag. ##### Escient artwork application data (?) is processed as ARTWORK tag. ##### /add details of other tags/ #### WMA - as specified by documend linked from http://www.microsoft.com/windows/windowsmedia/forpros/format/asfspec.aspx ##### TRACKNUMBER tags are processed as the TRACKNUM tag. ##### ALBUMTITLE tags are processed as the ALBUM tag. ##### AUTHOR tags are processed as the ARTIST tag. ##### PARTOFACOMPILATION tags are processed as the COMPILATION tag. ##### /need to check this ?/ ### Tag processing #### '''ARTIST tag:''' gets placed in the 'name' column of the 'contributor' table in the Slimserver database. A version of the ARTIST tag is stripped of articles, special characters, and set to upper case, and copied into the 'artistsearch' column. #### '''ARTISTSORT tag:''' if it exists, is placed in the 'namesort' column. If it does not exist, the ARTIST tag is duplicated into the namesort column. The string is stripped of articles, special characters, and is set to upper case. Lists of artists in the UI are sorted by the namesort field. /See bug(s) 4427./ #### '''REPLAY_GAIN_TRACK_GAIN:''' (position in DB needs adding) #### /add details of where the other tags appear in the DB?/ #### '''COMMENT:''' tags will be stored in the ??? column. When requested by the server components these will be interpreted. That is, comment processing is performed once the data is read from the database, not on store. This allows the processing to change in later versions without requiring a reindex, at the expense of processing speed when this tag is requested. The value will be ignored if they contain the strings '[[SoundJam CDDB |SoundJam_CDDB_]]', 'i[[Tunes CDDB |Tunes_CDDB_]]' in order to ignore the application-specific private tags used by [[SoundJam]] and iTunes. Any string which starts with a space followed by 8 hex digits then a '+' or space character, or a space followed by 2 hex digits then a '+' and 32 hex digits, will be ignored. Where multiple comments are present these will be handled as if they are concatenated together with a ' / ' sequence. Any string which begins with 'eng' will be stripped of these leading characters. ## [[SoundCheck]]/[[ReplayGain]] ## Database Notes: ### The 'customsearch' column is used for Stuart's popular '[[LazySearch]]' plugin. ### See [[SlimServerDatabaseStructure]] for more details regarding the structure of the database. # Localization/Internationalization # CLI # [[XPL]] # Plugin API # Firmware Updates # Alarm clock # Command line options # convert.conf # types.conf # strings.txt # Prefs file # Cache directory ## Web page cache ## Font cache ## [[MySQL]] ### slimserversql.db ### my.cnf ## mdns.conf # Softsqueeze # Bonjour/mDNS # Shipped Plugins ## Network Health ## Random Play ## RS232 ## [[SlimTris]] ## Snow Screensaver ## IR Blaster ## Switch to [[SqueezeNetwork]] # [[SqueezeNetwork]] Settings Sync # Platform Specific ## Windows ### Installer #### Installer also installs slimtray ### System Tray Application (slimtray.exe) #### Start Slimserver #### Stop Slimserver #### Automatically run at system start #### Automatically run at login #### Go to Slimdevices web site #### Exit ## Mac ### Installer ### Preference Pane ### ~/Library/[[SlimDevices]] ## Linux ### RPM ### Debian Package '''A note about [[SqueezeNetwork]]<nowiki>:</nowiki>''' While Squeeze Network uses [[SlimServer]], it is a larger project with different goals. There may be notes within this specificaton that some [[SlimServer]] feature or other is required for [[SqueezeNetwork]]. However, the specification of the Squeeze Network project is outside the scope of this document. [[Category:Squeezebox Server]] [[Category:Development]]

Return to Slim Server Specification (6.5.1).