Navigator Suite v1.4.0 How-To

Navigator Suite v1.4.x

KNOWN ISSUES:

None

READ THIS! IMPORTANT

All configuration is done at the beginning of the global-string. You don't need to change any strings in the columns-screen. Don't ask for support and don't report bugs if you changed anything outside of the configuration-sections.

How Albummode and Singlemode works:
"Navigator" comes with two fcs-versions - "Albummode default" and "Singlemode default". Both variants support both modes, but they differ in the priority as of which of the modes is the "default".

The non-default mode is activated by certain keywords in the name of a playlist. When for example you use "Albummode-default" then you can activate Singlemode by having "-s-", "single" or "default" somewhere in the name of your playlist. With the "Singlemode-default" Version, you can enable albummode by having "-a-" or "album" somewhere in the name of your playlist.

Do NOT try to manually force Single/Albummode in the column-prefs: This will break things badly. Only enable album/singlemode with the method explained above(playlistname-keywords). Some people seem to not get this, so i'll repeat it a second time: You can NOT change how album- and singlemode is triggered by simply changing the settings in the column-preferences!

How Hybrid-Mode works: Hybrid-Mode means having single-tracks in Albummode. A track is considered a single in the following cases:
- it is trackgained but not albumgained
- no tracknumber could be detected(either via tag or guessing)
- it has a singletrack-tag
- it has a TOTALTRACKS value of "1"

Individual columns can be enabled and disabled by just rightclicking on the column-headers in the playlist.

Editing tags right in the playlist(inline fieldediting): Some areas in the playlist allow to directly edit the tags of the track by simply clicking the area two times. This is an "afterthought-feature" in Navigator - it does not work perfectly and there are no plans to improve it for the 1.4.x series. It will however be implemented in a better way someday in the future(no ETA).

You can change which lines are displayed in the systray-popup by going to the "Title Formatting"-Page under "Display" in the Preferences. There choose the systray-tab and you will see a config-section where you can individually enable/disable whats shown in the systray.

There is currently no way for the FCS to automatically change the playlist background-color depending on the choosen color-scheme. To change it manually, go to the ui_columns prefs, "Playlist-view"-section, colors and fonts tab. Under "Colors" change the "Background" color to whatever you like.

FEEDBACK, QUESTIONS, BUG-REPORTS, ETC:

Please don't mail or PM me. You're welcome to post feedback in the following ha.org forum-thread. This will avoid multiple people asking the same questions and also makes it easier for me to keep track of things.

Do not post any bugs or feature-requests in that thread without having read everything above on this page.

http://www.hydrogenaudio.org/forums/index.php?showtopic=31509

Bonus Material:

NAVIGATOR COPY-STRING

// BASIC CONFIGURATION // ========================================= // how much information to copy: // 1=basic, 2=normal, 3=overkill, 4=flood! $puts(infolevel,2) // what's the emote command which you use in your chat-app? // usually, this is '/me ' or '/emote ' // (keep the 'single quotation marks' intact!) $puts(emote_command,'/me ') // what to usually write between the emote-command and // the currently playing song $puts(emote,'np: ') // ======================================== // ! End of configuration ! // ======================================== // METADATA-DETECTION CORE [begin] // =================================== // by Lyx: moonblade@nospammail.net // if you use this in your own strings, then please keep the credits above // get filename and do cleanup $puts(filename,$if2(%__referenced_file%,%_filename%)) $puts(filename,$replace($trim(%_filename%),'_',' ','%20',' ',' ',' ',' ',' ')) // if all guessable tags there, disable guessing $if($and(%artist%,%album%,$meta_test(title,tracknumber)), $puts(enable_guess,0)) // check if guessing is disabled - in that case use tags-only and skip guessing $if($strcmp($get(enable_guess),0), $puts(artist,[%artist%]) $puts(album,[%album%[ - CD%disc%]]) $puts(title,%title%) $puts(tracknr,[%tracknumber%]) $puts(folder,$replace(%_directoryname%,_,' ','%20',' ',' ',' ')), // START GUESSING $puts(filename2,$get(filename)) // START TRACKNR-GUESS $if($meta_test(tracknumber),$puts(tracknr,$num($tracknumber(2),2)), // set default tracknr_check to 2 (nothing found yet) $puts(tracknr_check,2) // search for 1st two digits $puts(fname,$replace($substr($get(filename),1,2),0,1,2,1,3,1,4,1,5,1,6,1,7,1,8,1,9,1)) $if($strcmp($get(fname),11), $puts(tracknr_check,1) $puts(fname,$replace($substr($get(filename),3,3),' ',1,'.',1,'-',1)) $select($get(fname), $puts(tracknr,$left($get(filename),2)) $if($strcmp($substr($get(filename),3,4),' -'), $puts(filename,$right($get(filename),$sub($len($get(filename)),4))), $puts(filename,$right($get(filename),$sub($len($get(filename)),3))) ) // end select 1 & 2 )) // search for -??- and - ?? - $select($get(tracknr_check),, // 1st pass $if($strchr($get(filename),'-'), $puts(fname,$strchr($get(filename),'-')) // - ?? - $if($and( $strcmp($substr($get(filename),$add($get(fname),5),$add($get(fname),5)),-), $strcmp($replace($substr($get(filename),$add($get(fname),2),$add($get(fname),3)),0,1,2,1,3,1,4,1,5,1,6,1,7,1,8,1,9,1),11) ), $puts(tracknr_check,1) $puts(tracknr,$substr($get(filename),$add($get(fname),2),$add($get(fname),3))) $puts(filename,$replace($get(filename),'- '$get(tracknr)' ',)) , $puts(fname2,$right($get(filename),$sub($len($get(filename)),$add($get(fname),2)))) ))) // 2nd pass $select($get(tracknr_check),, $if($strchr($get(fname2),'-'), $puts(fname,$strchr($get(fname2),'-')) // - ?? - $if($and( $strcmp($substr($get(fname2),$add($get(fname),5),$add($get(fname),5)),-), $strcmp($replace($substr($get(fname2),$add($get(fname),2),$add($get(fname),3)),0,1,2,1,3,1,4,1,5,1,6,1,7,1,8,1,9,1),11) ), $puts(tracknr_check,1) $puts(tracknr,$substr($get(fname2),$add($get(fname),2),$add($get(fname),3))) $puts(filename,$replace($get(filename),'- '$get(tracknr)' ',)) ))) // 3rd pass (search backwards) $select($get(tracknr_check),, $if($strrchr($get(fname2),'-'), $puts(fname,$strrchr($get(fname2),'-')) // - ?? - $if($and( $strcmp($substr($get(fname2),$sub($get(fname),5),$sub($get(fname),5)),-), $strcmp($replace($substr($get(fname2),$sub($get(fname),3),$sub($get(fname),2)),0,1,2,1,3,1,4,1,5,1,6,1,7,1,8,1,9,1),11) ), $puts(tracknr_check,1) $puts(tracknr,$substr($get(fname2),$sub($get(fname),3),$sub($get(fname),2))) $puts(filename,$replace($get(filename),'- '$get(tracknr)' ',)) ))) ) // END TRACKNR-GUESS // cleanup-filename (2nd pass) $puts(filename,$replace($trim($caps2($get(filename))),' ',' ',' ',' ',--,-,- -,-,- -,-)) // artist/title-guessing $puts(fname,$replace($get(filename),' - ',?)) $puts(artist,$replace($substr($get(fname),1,$strchr($get(fname),?)),?,)) $if($not($strcmp($get(artist),$char())), $puts(title2,$replace($right($get(fname),$sub($len($get(fname)),$add($len($get(artist)),1))),?,' - ')), $if($strcmp($get(filename),$get(filename2)),$puts(title2,),$puts(title2,$get(filename))) ) $puts(artist,$if2(%artist%,$get(artist))) $puts(title,$if($meta_test(title),%title%,$get(title2))) $if($not($meta_test(title)),$if($stricmp($get(title),$char()),$puts(title,))) // cleanup foldername $puts(folder,$replace($trim($caps2(%_directoryname%)),'_',' ','%20',' ',' ',' ')) // If a CUE-Sheet is used, use CUE-filename instead of folder $puts(fname,$if(%__referenced_file%, $replace($caps2(%_filename%),_,' ','%20',' ',' ',' '), $get(folder) )) // album/folder-guessing $if(%album%,$puts(album,%album%[ - CD%disc%]), $puts(fname,$replace($get(fname),' - ',?)) $puts(artist2,$replace($substr($get(fname),1,$strchr($get(fname),?)),?,)) $if($not($strcmp($get(artist2),$char())), $if($strcmp($get(artist),$char()),$puts(artist,$get(artist2))) $puts(album,$replace($right($get(fname),$sub($len($get(fname)),$add($len($get(artist2)),1))),?,' - ')), $puts(fname,$get(title2)) $puts(fname,$replace($get(fname),' - ',?)) $puts(album2,$replace($substr($get(fname),1,$strchr($get(fname),?)),?,)) $if($not($strcmp($get(album2),$char())), $puts(title2,$replace($right($get(fname),$sub($len($get(fname)),$add($len($get(album2)),1))),?,' - ')) $puts(album,$get(album2))$puts(title,$get(title2)), )) ) // END GUESSING ) // VARIOUS ARTISTS // skip VA-check if albummode is disabled $select($get(albummode_active), // check album-artist $if($meta_test(album artist),$puts(albumartist,$meta(album artist)), // check non-standard va-tags $if($strstr($replace($lower(%various artists%%various%%va%),va,1,'v.a.',1),1) ,$puts(albumartist,'Various Artists') ) // end album-artist check ) // guess from filepath $if( // only if tag-based detection failed and guessing is enabled $and($strcmp($get(albumartist),$char()),$strcmp($get(enable_guess),1)) , // guess $if($or( $strstr($lower(%_path%),'v.a.'), $strstr($lower($replace(%_path%,' ',$char(),'_',$char())),'\va-'), $strstr($lower($replace(%_path%,'_',' ')),'various artists'), ) ,$puts(albumartist,'Various Artists')) // end filepath-guessing ) // end albummode-check ) // set 4-character filetype $puts(filetype,$upper( $if(%__referenced_file%,$cut($ext(%__referenced_file%),4), $if($stricmp($left(%_path%,4),cdda),CD,$cut($ext(%_path%),4) )) )) // detect detailed filetype2 $puts(filetype2,$replace($get(filetype), WAV,[%codec% ]WAVE, AC3,Dolby Digital, CD,Audio CD, MKA,Matroska[ %codec%], OGG,Ogg[ %codec%], MP4,MPEG-4[ %codec%], M4A,iTunes[ %codec%], MP2,MPEG Layer 2, MP3,MP3[' ('%__lame_version%')'], MPC,Musepack, OFR,OptimFROG, OFS,OptimFROG DS, FLA,FLAC, APE,Monkey''s Audio, WV,WavPack, SPX,Speex, SID,C64 SID-Tune, MDZ,Soundtracker Module, S3Z,Screamtracker Module, ITZ,Impulsetracker Module, XMZ,Fasttracker II Module, MO3,Compressed Module, MOD,Soundtracker Module, S3M,Screamtracker Module, XM,Fasttracker II Module, IT,Impulsetracker Module, UMX,Unreal Music File, MTM,Multitracker Module, )) $puts(filetype2,$replace($get(filetype2),FLACC,FLAC)) // set quality-info (bitrate, etc.) $puts(quality,$if2(%__codec_profile%, $puts(ratio, $if($or($strstr(%__compression%,Lossy),$stricmp(%codec%,DualStream)),, $muldiv($info(bitrate),1000, $div($mul(%samplerate%,$info(bitspersample),$channels()),100) ))) $ifgreater($get(ratio),0,$ifequal($get(ratio),100,,$get(ratio)'%' compr.) ,[%bitrate%kbit]) [$info(mod_channels)ch] $if($strcmp(%codec%,MP3),' '$if2(%__extrainfo%,CBR) [' / '$upper($abbr(%__mp3_stereo_mode%))]) )) $puts(quality2,$replace($get(quality),[$info(bitrate_dynamic)],[$info(bitrate)])) // =================================== // DETECTION CORE [end] // our results are: $artist*, $albumartist*, $album*, $title*, $tracknr*, $folder, // $filename, $filetype, $filetype2, $quality*, $quality2* // * means if available // OUTPUT // ============================================================ // insert intro and emote $get(emote_command)$get(emote) // artist $if($not($strcmp($get(artist),$char())),$get(artist)) // album $ifgreater($get(infolevel),1,$if($not($stricmp($get(album),$char())), ' - ['$get(album) $ifgreater($get(infolevel),2,[' ('%date%')'],) ']' ),) // title $if($not($stricmp($get(title),$char())), ' - ' $ifgreater($get(infolevel),1,$if($not($strcmp($get(tracknr),$char())),'#'$get(tracknr)'.'),) $get(title) ) // details-line $ifgreater($get(infolevel),2, // build details-line ' [' $get(filetype2) $if($not($strcmp($get(quality2),$char())),' / '$get(quality2)) $ifgreater($get(infolevel),3,$if(%__replaygain_album_gain%,' / Albumgain: '%__replaygain_album_gain%, $if(%__replaygain_track_gain%,' / Trackgain: '%__replaygain_track_gain%)),) ']' ,) // foobar version $ifgreater($get(infolevel),3,' ['$replace([%_foobar2000_version%],foobar2000,Fb2k,' ',_)']',)