Professional Documents
Culture Documents
Many thanks to: T.P Wang, Br3tt, fbuser and super-gau for their helping hands with scripting in WSH Panel mod aleco and grimes for their helping hands in creating the self-extracting file and to all of m beta testers!
For questions and pro lems that can!t e sol"ed y reading this user guide you can contact me on the following sites: "ar#$ne in t%e german foobar-users-&orum and of course on deviantart
Many thanks for using "ar#$ne v2.0 # $%&% tedGo aka 'erhard
&
Select Splitter Settings 0 Script 0 Per3rack and change the lue framed Script part illustrated elow to your desired Path and <aming format:
3itle Formatting skills may e necessary, Wildcards for file extensions or file names) e, g, artist<.< instead of artist=0'.>pg) are possi le,
2. Usage
2.1 ontrol buttons
3hese uttons should e self-explanatory, -t may e mentioned that the uttons position will e rearranged depending on your display resolution 4upper illustration shows the "iew on displays smaller than &$>%;x) in the middle smaller than &7%%;x and at the ottom higher than &7%%;x1 and that there will appear an additional utton on resolutions higher than &7%%;x, 3he .*2T.&+ utton as seen on the screenshot only appears if the optional Plugin foo?lastfm?radio,dll is present in your foobar20005components folder, +therwise there!s a 0.)*( .12T utton on resolutions smaller than &7%%;x and an *"" .$0. utton 4to add an 52: to the Playlist1 on higher resolutions,
2.2 !ating"#anel
8ccording to the chosen mode the stars in the rating panel will display (atings 7/%ite9) Pla counts 7green9 or an automatic rating 7blue9 generated y informations from the now playing track, 3he needed function is selecta le through a context menu y right-clicking the stars: 3he illustration on the left shows the context menu that is e6clusivel a"aila le during pla bac# of a file that is present in the Media :i rary) ecause the options only take effect on these files, -n 2T$P-state the .normal/ context menu of the panel 4Properties and 0onfigure only1 is displayed instead, For tracks outside the Media :i rary there is only a asic menu a"aila le during play ack) that allows the user to delete existing manual ratings 4"elete rating1 and allows access to the panels Properties and its script 40onfigure1,
Properties Halls the Properties-Window of the panel, -f you D for whate"er reason - can!t imagine,,, - don!t want to use the context menu) you can change the "ispla +ode 40 for ShowCena le rating) ' for Show auto-rating or 2 for Show playcounts1) the (ating +ode 40 for 2ate to data ase or ' for 2ate to file tags1 and the Pla counter limit 4as num er from 0-61 here, 0onfigure Shows the script of the panel, 1t is strongl dis-recommended to c%ange an t%ing in t%is script /it%out an #no/ledge about t%e script language! ,ote3 3o a"oid a confusing mixed-rating-display the rating panel is set up to prefer tag rating if the file is dou le rated in the data ase *," the tags with different "aluesI 5nder this circumstances it may happen that database rating will e ignoredI
2.$ Display
3he progress bar is also a see#bar in which you can drag with the left mouse utton or the mouse wheel to e"ery point in the playing file, 3he .seek time/ will elow, e displayed in the display
Since there is no seeking possi le in 2treams the seek ar function is deacti"ated y listening to them, 3here are further informations displayed in the display D as long as they are a"aila le, .$22A?.$22.)22 D shows if the playing file is encoded lossy or lossless, *U"1$ +"B D lights up when the playing file has a M*E checksum, ()P.*AG*1, D light up when the playing file has 2eplaygain info, 3he 9lapsed-C2emain-3ime and (itrate will e replaced y the "olume "alue on volume c%anges for a out t%ree seconds, 3here!s a Pea#meter elow the information unit) which appearance can e fit to your needs, 3o do so right-click on it and choose Preferences, 3o change its appearance may e necessary when you change the glo al colour scheme of *ark+ne 4see c%apter 2.'31 since the Peakmeters ackground colour doesn!t adopts the settings made in Holumns 5automatically, 3he according settings are db (ange 4in the upper left corner of the Preferences window1 and the 0olors utton 4downright of the window1, -f you ha"e changed its settings and you!re not satisfied with the result you can go ack to configurations default setting y choosing the P)*:default.pmf from the "ar#$ne25$t%ers52ettings folder with the 1mport 2ettings option in its context menu,
Please click on the +),U utton 4on the left a o"e the Playlist "iews1 and choose &ile - Preferences "ispla , Here is the place to add your naming schemes andCor paths for up to four images 4&ront cover, Bac# cover, *rtist 4for an artist picture1 and "isc1 you may want to display in the co"er panel and D at least the Front co"er and the 8rtist D in the Playlist "iews, 3itle-Formatting and Wildcards are possi le, -n addition you can set up paths to 2tub images for each ta to display when there!s no match in the Search pattern and you!re not satisfied with the default *ark+ne stu images, 3hese stu images will e displayed in the Playlist "iews too 4see c%apters 2.; E 2.'01, 8t least it is recommended to set up a stu image for the &ront cover when you ha"e acti"ated al um art display in <' Playlist 4see c%apter 2.81 since this Playlist "iew can!t e preconfigured to use the *ark+ne default images, -f you want to use the *ark+ne default <oHo"er--mage) that is already used y the configuration except y the <' Playlist) you!ll find it in the ...5foobar20005"ar#$ne251mages folder,
>
-n the middle of the configuration is a "isualisation called 0%annel 2pectrum Panel, 3his panel is preconfigured to its maximum capacity and may increase HP5 consumptionI 3o fit the channel spectrum to your needs) right-click on it and choose 0onfigure, -f you ha"e changed its settings and you!re not satisfied with the result you can go ack to configurations default setting y choosing the 02Pdefault.csp from the "ar#$ne25$t%ers52ettings folder with the 1mport utton,
3here!s a thin ar with additional uttons a o"e the Playlist "iews) that allows fast and easy access to their functions, 3he +),U utton opens the foo ar$%%% Menu, 3he +usic note Kumps to the file that is now playing) useful for instance if you were usy in another Playlist and want to return to the now playing file immediately, 2ight esides it there is the 2top-after-current utton that stops play ack after the now playing file, 2ight esides the Stop-8fter-Hurrent utton is the utton to change the Pla bac# $rder, When clicking on it a menu opens) that allows you to choose the desired play ack order as followed: "efault D plays files in the order they are in the Playlist (epeat 7pla list9 D repeats the acti"e Playlist (epeat 7trac#9 D repeats the now playing file (andom D chooses tracks randomly from the acti"e Playlist) where tracks may e played more than once 2%uffle 7trac#s9 D chooses tracks randomly from the acti"e Playlist) where tracks are only played once 2%uffle 7albums9 D chooses al ums randomly from the acti"e Playlist 2%uffle 7folders9 D chooses folder content randomly from the acti"e Playlist 3o indicate the chosen play ack order the utton image changes itself according to your choice, 3he three uttons on the right are switching etween the different Playlist "iews, 3he utton on the left acti"ates the default Playlist "iew 49:Playlist) see c%apter 2.;1, 3he middle utton acti"ates the <' Playlist 4see c%apter 2.81, 3he utton the right acti"ates the MiniPlaylist "iew 4see c%apter 2.'01 on the left down side of the configuration, 3he Ho"er panel .mo"es/ to the usual place of the Playlist instead and turns to the (ig Ho"er Biew,
-n the red framed text ox in the illustration a o"e please type-in your desired grouping scheme, -n the blue framed text ox in the illustration a o"e please type-in your desired sorting scheme, 3here is the possi ility to set up additional sorting schemes in the 9:Playlist, Gou!ll find this possi ility under 2ettings 0 +isc ta 0 *dditional sort format for conte6t menu, Please gi"e your new sorting scheme an expressi"e name under "ispla name and type-in your desired sorting string in 2ort format, Hlick add after doing it and your new sorting scheme is added to the list, 3o access this sorting scheme from your Playlist "iew you ha"e to enhance your context menu with the entry 2ort, 3o do it) please go to the Be%aviour ta , 8t the ottom of this ta you!ll find the entry 0onte6t menu, Hhoose 2ort from the drop-down menu and ena le 2%o/, 8fter hit $: your changes are stored and you can use them,
&%
3o tell the popup-window the correct transparency colour) right-click in the Playlist "iew 2ettings 0 +isc ta ,
Hlick on the colour... utton and choose the transparent colour 4as seen in the illustration on the left1, Honfirm your action with $: to return to the +isc ta , Gou can change the degree of transparency of the popup-window with Popup opacit , 3he default "alue is 22G, 3he lower the "alue the higher the transparency effect, 8fter hit $: your changes are applied to your Playlist "iew, ,ote3 Gou must do these changes for the +ini-Pla list 4the right utton a o"e the playlist1 separately) ecause it has a popup-window too,
&&
3o change an entry dou le-click on it and o"erwrite the content of the "efinition text ox with your desired stringC"alue,
&$
1+G.P*TK 3he path to the folder where the images for drawing the Playlist "iew are stored, P$PUP.1+G.P*TK 3he path to the image that is displayed in the popup-window, (y default the popup-window displays the 8rtist picture pro"ided y the foo ar$%%% artreader 4Lel=group=first=pat%L1, +f course you can change it and enter a concrete path to an image here, 3itleFormatting) relati"e paths and Wildcards are possi le 4for instance: Mdirector =pat%7Lpat%L95artist.< or 035+usic5*rtist Pictures5LartistL<.<) depends on your naming schemes and paths1, T%is ma be necessar /%en ou /ant to displa an artist picture %ere ) since the 9:Playlist only displays the image associated with the first file in a group when using the foo ar$%%% artreader 4for this reason a Iarious stu image will e displayed for Samplers y default1, P$PUP.1+G.$PT1$, 3he options for the path you!"e entered in P$PUP.1+G.P*TK, (y default the options are artreader=artist nodela ) that means that the foo ar$%%% artreader is used for displaying the .8rtist/ image 4artreader=artist1 and it will e displayed without delay 4nodela 1, -f you ha"e entered another path than the foo ar$%%% artreader 4 Lel=group=first=pat%L1 in P$PUP.1+G.P*TK you must drop the artreader part completelyI 3hen you!ll ha"e the following additional options: /c D ena les Wildcards for the path entered in P$PUP.1+G.P*TK no#eepaspect D the image will e stretched without respecting the aspect ratio noe6pansion D is only shrinking) not expanding, Gou can use more than one option and ha"e to separate them only with 2P*0),
2.+.3.2 olumns"2anagement
0$.U+,.J.$, 4for the columns two and three onlyI1 Gou can ena le additional columns here) where the following entries can e done in the "efinition text ox: 0 M deacti"ated 4default1 ' M acti"ated 0$.U+,.J.T)JT Please type-in the text or 3itle Formatting string that should e displayed in the column, 0$.U+,.J.&$,T Please enter the font style for the column here, 3hat has to e done in means for instance: Mfont7*rial Unicode +2,'0,9 the following scheme: Nfont4O &$,TP)O&$,T21N)P)O$PT1$,2P1
4the columns will e displayed with the font style 8rial 5nicode MS with &% points siJe) without any options1
&=
3he following options are selecta le and can e com ined: bold italic underline stri#eout For normal text Kust lea"e the space ehind the comma empty, 0$.U+,.J.2K*"$W With entering the "alue ' you can ena le a shadow for the column!s text, *isa ling it is possi le with entering the "alue 0, 0$.U+,.J.*.1G, 3o set the horiJontal align of the column as left, rig%t or %center, 0$.U+,.J.W1"TK 3o set the width of the column 4column one adKusts its width automatically depending on the "alues you entered here for column two andCor three1,
2.+.3.3 !ating"Display
(*T)."12P.*A Here you can decide what to display in the rating area of the playlist) where following entries can e done in the "efinition text ox: 0 M display ratings 4/%ite1 ' M display an automatic rating 4blue1 4see chapter $,$,& for details1, 2 M displays play counts 4green1 (y default the rating area will display the rating 4Q 0.1, (*T).B*(.+$") Here you can choose if the rating area should e displayed as stars or a ar) where following entries can e done in the "efinition text ox: 0 M Stars ' M (ar (y default the rating area will e displayed as stars 4Q 0.1, P.*A0$U,T..1+1T -ndependent from the rating panel you can set up the amount of play counts a song has to e left efore displaying all starsCthe whole ar, Please enter a positi"e "alue for "efinition! (y default all starsCthe whole ar will e displayed when B0 play counts are reached, ,ote3 -f you enter a wrong "alue in one of the three options a o"e the default eha"iour will e executedI
&@
2.3 41 #laylist
3he <' Playlist is the second Playlist "iew in the *ark+ne configuration 4the middle of the three uttons rightmost a o"e the Playlist "iews1,
2.8.2 Grouping
3o synchroniJe the grouping in <' Playlist and the 9:Playlists 4Main Playlist "iew and MiniPlaylist1 you!ll find a ,G Pla list Grouping.t6t in the folder ...5foobar20005"ar#$ne25$t%ers52ettings that contains a suita le 3itle-Formatting string, Please copy this script preset to +),U - &ile - Preferences - 0olumns U1 - Pla list vie/ - Grouping ta y dou le-clicking on the existing preset and o"erwriting it with the copied content,
2.8.3 (ating
Same as 9:Playlist and the rating Panel you can change the eha"iour of the rating display in the <' Playlist, Please na"igate to +),U - &ile - Preferences - 0olumns U1 - Pla list vie/ - 0olumns ta and choose the columns (ating, <ow choose the 2cripts - "ispla ta , (ating +ode 3o switch the mode go to Mputs7rating.mode,09 and change the 0 7(ating9 to ' 4displaying the calculated *uto-(ating as descri ed in c%apter 2.21 or 2 4displaying the Pla counts1, Pla counter-.imit 3o set up the amount of play counts a song has to e left efore displaying all stars in rating mode $ go to Mputs7count.limit,B09 and change the B0 to the desired amount of play counts, Please read t%e 0olumns U1 "ocumentation for more details on %o/ to t%e options of t%e ,G Pla list.
&E
With the "olume wheel you can adKust the "olume with the mouse /%eel or the left mouse button, Bolume changes are displayed with a lightened position indicator for a out three seconds and as "alue in the display on the left side of the configuration, Gou can select Iolume +ute with right-click on the "olume wheel, 3he position indicator will turn to red as long as the "olume is muted, For the functions of the 4uic# 2earc% Toolbar please read the Kelp page of in +),U - &ile - Preferences - +edia .ibrar - 4uic# 2earc% Toolbar,
2.12 2ultipanel"S,itcher
Gou can switch etween preconfigured panels with the uttons on the right down side of the configuration,
&7
&F
*ou le-click on the area that is blue framed in the illustration on the left and type-in your path and naming scheme, 3itle-Formatting and Wildcards are allowed, -t is possi le to load lyrics from the internet with additional) optional components, Since these components are in alpha-state or also insta le they!re not included in *ark+ne "$,%, (ut the lyrics panel is preconfigured for working together with foo?lyricsgra oth will store the found lyrics to the file tags, er andCor foo?lyricsd that are
Should one of these two components already exists in your foo ar$%%% components directory there will e automatically an additional entry in the panels Properties window with a suggestion for a suita le download command, 2%ould bot% e6ist in our components folder t%e . ricsgrabber /ill %ave priorit over foo=l ricsdb, Gou!ll also ha"e the additional command $nline 2earc% in the context menu, -f you download one of these two components after installing *ark+ne "$,% it may e necessary to go to the Properties window and hit 0lear to make the panel recogniJing the new component, (ut this will force you to enter your path and naming scheme to external lyrics files again, Padding 3here are two further options a"aila le in the Properties window to add padding etween the panel oarder and the lyrics 4see illustration a o"e1,
&>
2.'2.2 Panel-+anagement
-t is of course possi le to add) remo"e or mo"e panels) where y the panel-manager is limited to manage up to eig%t panels, 3o manage the panels please na"igate to +),U - &ile - Preferences - 0olumns U1 - .a out ta , Scroll down to the following "iew: 3o remove a panel right-click on it and select (emove panel, 3o move a panel right-click on it and select +ove up or +ove do/n, 3o add a panel right-click on the Panel 2tac# 2plitter and select *dd Panel, 8fter this action please select the Panel 2tac# 2plitter and hit the utton 0onfigure... on the right down side of the window, Select the new added panel in the Panel.ist) set the cursor in the 0aption ox and gi"e it an up to three letters token, <ow tick &orced .a out for the new added panel and press $: to finish your action, Hlick on *ppl for applying your changes to the configuration,
&L
Use custom active item frame is acti"ated and its default colour is: 7=-&%%-&$F, 3oo ad that some components will ignore these colour settings,,, 3hese panels are Panel Stack Splitter) 9:Playlist and some parts of the *isplay, 3o change their colours please do the following: Panel 2tac# 2plitter 2ight-click on one of the three uttons rightmost a o"e the Playlist "iew,
Hhoose Splitter Settings 0 Script 0 Per3rack and change the lue framed Script part in the illustration elow to the desired colour 42-'-(-81:
8pply your action y pressing $:, ).Pla list Please read c%apter 2.;.3.' to see how to change the colours for 9:Playlist 4default Playlist "iew and MiniPlaylist1, *isplay Please read c%apter 2.G to see how to change the colours of the Peakmeter, Gou can also change the colours of the Trac# number) Pla ing Time) Bitrate and 1nfobo6es, 3o do so please right-click on the display) choose 0onfigure and change the blue framed Script parts as illustrated elow 42) ') () 81:
$%
$&
3. Troubles%ooting
)(($( ()*2$, P$221B.) 2$.UT1$,
T%ere are some parts of t%e -n "ery rare cases the Panel Stack Please restart foo ar$%%% configuration 7images?panels9 Splitter seems to .forget/ some missing after foobar2000 start- details up! foobar2000 cras%es randoml Gou are using outdated or Plugins uggy Please search for updates or use Plugins pro"ided with the *ark+ne installer 2emo"e unused and pro a ly outdated Plugins from your ...5foobar20005components folder Please inform me a out crashes when they are caused y Homponents pro"ided with the *ark+ne download so - can remo"e them immediatelyI T%e (ating Panel and t%e rating 3he play count limit is set much Hhoose a higher limit for the play displa in t%e Pla list are too low, counts as descri ed in c%apters displa ing al/a s all stars?t%e 2.2.' and 2.;.3.3 /%ole bar in Pla counter mode! T%ere are no covers displa ed in 3he 9:Playlist is using the t%e ).Pla list! foo ar$%%% artreader ut your al ums don!t ha"e em edded al um art nor al um art that the artreader can recognise, Hhange the name of your co"ers to folder,;) co"er,; or front,; 8dd a new suita le naming scheme to Preferences - "ispla Hhange P$PUP.1+G.P*TK and P$PUP.1+G.$PT1$, in the 9:Playlists field definitions as descri ed in c%apter 2.;.3.' T%e ).Pla lists Popup /indo/ 3he 9:Playlist only displays the doesn@t s%o/s t%e correct image! image associated with the first file in a group when using the foo ar$%%% artreader, Hhange P$PUP.1+G.P*TK and P$PUP.1+G.$PT1$, in the 9:Playlists field definitions as descri ed in c%apter 2.;.3.'
$$
)(($(
()*2$,
P$221B.) 2$.UT1$,
1 c%anged a script part of a W2K Seems you made a mistake S1 Panel and it doesn@t /or# an more!
'o to the affected WSH Panel) right-click on it and choose 0onfigure, -mport the associated script with the 1mport utton from the folder "ar#$ne25$t%ers5W2K 2cripts
1 made some c%anges in t%e +ops,,, ).Pla list but /ant to return to t%e default settings!
2ight-click in the 9:Playlist) choose 2ettings 0 1mport and import the file ).Pla list.elp from the folder "ar#$ne25$t%ers52ettings 2eimport the file "ar#$ne v2.0.fcl
1 made some c%anges in t%e Shit happens :1 configuration but /ant to return to t%e default settings!
0PU-consumption is muc% 3he "isualisation is set to its Hhange its Settings as descri ed in %ig%er /it% "ar#$ne v2.0! highest capacity c%apter 2.T
foobar2555 free)es on track change ,hen listening to last.fm -optional0 for a fe, seconds
5nknown reason
5nknown :4
foobar2000 often freeSes during Gou use outdated or uggy Plugins Please search for updates or use pla bac#! Plugins pro"ided with the *ark+ne "$,% package 3he Biograp% vie/ panel is set 2ight-click on the (iography "iew up too power consumpti"e for panel and deacti"ate $ptions 0 your system *uto 0 cle 1mage 2ight-click on the (iography "iew panel) choose Panel Preference... and select &ront (enderer G"1U (*+ usage raises %ig%er and 3he Biograp% vie/ panel seems *eacti"ate *uto 0 cle 1mage %ig%er during pla bac#! to sa"e all informations and images loaded during play ack in 2ight-click on the (iography "iew your 28M without disposing them panel) choose Panel Preference... and deacti"ate 2%o/ Te6t and 2%o/ 1mage
$=