foo. bar. baz. quux.

From WikiBazQuux

As of May 2009, I'm taking down all foobar2000 related files.

As of May 2008, I will no longer be developing foobar2000 components.

I no longer wish to contribute my time to a closed source, single platform app.

Also, certain actions by the foobar2000 developers have lead to my no 
longer wishing to contribute.  These include removing features utilized by 
developers and users because they dislike they way they are  being used and 
allowing only an elite few access to new API features.

Thank you to loyal users over the past years. 

If you are a developer and are interested in taking over 
development of one of my components, please email me at 
chris SQUIGGLE bowron SLAM us.

foo_cwb_hooks is a collection of utilities.

• Adds various functions and variables to global title formatting
• Masstagger action: "Stamp Current Date and Time"
• New File Tagger - Ability to run a script on files added to the media library
• Tagger Window - Columns UI panel for tagging files

• foo_cwb_hooks.zip
• Discussion
• Changelog

Contents 1 Functions 2 Variables 3 Known Bugs 3.1 Not Bugs 4 Feature Requests 5 Useful Strings 6 Developer Information

Functions

• $cwb_urldecode / $cwb_httpclean - decodes characters in URLs
• $cwb_removethe - removes The and A at the beginning of a string
• $cwb_ltrim - example: $cwb_ltrim(%artist%,The) $cwb_ltrim(%artist%,The ,A ,La )
• $cwb_datediff(d1,d2) - number of days between two dates in the format yyyy-mm-dd or yyyy-mm-dd hh:mm:ss
• $cwb_hms(n) converts a time in seconds into hh:mm:ss
• $cwb_wdhms(n) - weeks, days, hours, minutes, seconds
• $cwb_splitnum(n) - converts "12345678" to "12 345 678". optional second paramater can be delimiter (i.e. comma for comma separated)
• $cwb_fileexists(filename) - returns whether a file exists. useful for determining whether albumart file exists.
  • example: $cwb_fileexists($replace(%_path%,%_filename_ext%,)folder.jpg)

Variables

• %cwb_systemdate% - date in the formay yyyy-mm-dd
• %cwb_systemdatetime% - date and time in the format yyyy-mm-dd hh:mm:ss
• %cwb_activelist% - active playlist name
• %cwb_activelist_count% - number of items in the active list
• %cwb_activelist_duration% - seconds
• %cwb_playinglist% - playing playlist name
• %cwb_playinglist_count% - number of items in the playing list
• %cwb_playinglist_duration% - seconds
• %cwb_queueindex% - queueindex if in the queue, false otherwise
• %cwb_queueindexes% - indices of the item in the queue, false otherwise
• %cwb_queuelength% - length of the queue
• %cwb_queue_end_playlist% - playlist of the last item in the queue
• %cwb_next_title% - title of the next song in the playlist of the playing item or the next item in the queue
• %cwb_next_artist% - artist of the next song in the playlist of the playing item or the next item in queue
• %cwb_next_user1% - user definable string for next track (default %album%)
• %cwb_next_user2% - user definable string for next track (default %path%)
• %cwb_playback_order%
• %cwb_stopaftercurrent%
• %cwb_followcursor%
• %cwb_volume%
• %cwb_selection_duration% - in seconds
• %cwb_playback_state% - stop, play, pause
• %cwb_playing_index% (1 based)

Known Bugs

• playlist order not available until a song is played

Not Bugs

• When items such as %cwb_activelist% and other non-file specific changes happen, some components might not be refreshed because there is no mechanism in the SDK for telling other components to refresh. cwb_hooks adds a callback that other components can implement to allow them to get notified when a variable changes. If the component you are using does not refresh when cwb_hooks variables change, you might consider requesting this feature from the components author.

Feature Requests

Please do not request any new features along the lines of %cwb_next_*%. Most of them are not possible.

• wildcards in cwb_fileexists
• Add following functions:
  • $cwb_foobar2000_path, $cwb_foobar2000_drive, %cwb_activelist_filesize%, %cwb_selection_filesize%
  • $cwb_systemdate that works with win32 filetimes
• Add variables for the following:
  • selection index
  • play time start
  • last played, currently playing
  • %_replaygain_mode% - not really possible
  • %_database% - gives back if a file belongs to database or not
    • not easily possibe because you cannot use SDK functions in the title formatting callback
    • only way I could see to do it is to cache the library and test against that
• define actions when songs starts playing
• define actions when % of song completed
• define action when song ends
• allow wildcards in $cwb_fileexists

Useful Strings

'Played Today', 'Played Yesterday', 'Played n days ago' or 'No last played info' 

$if(%last_played%, $puts(diff,$cwb_datediff(%last_played%,%cwb_systemdate%)) Played $ifgreater(1,$get(diff),Today, $ifgreater(2,$get(diff),Yesterday, $get(diff) days ago)), No last played info)

Developer Information

As of version 1.0.9 foo_cwb_hooks implements a service to notify other components of changes to its variables, so that they can refresh their display if necessary. Notification is done inside of a main_thread_callback.

To use this functionality, declare the service using the following code. Note that The const char * parameter in on_var_change is the name of the variable that has changed, which can be scanned for in your formatting string to see if your display needs updating. Note that is some cases it might not be the exact variable, but for example cwb_next_ when cwb_next_artist, cwb_next_title, etc change.

class NOVTABLE titleformatting_variable_callback : public service_base 
{
public:
   virtual void on_var_change( const char * var ) = 0;

   FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(titleformatting_variable_callback);
};

const GUID titleformatting_variable_callback::class_guid = 
{ 0xfcb81645, 0xe7b2, 0x4bc1, { 0x92, 0xb0, 0xf6, 0xfb, 0x4b, 0x43, 0x70, 0xe3 } };

here's a sample implementation that just prints out the name of the variable that has been changed.

class sample_callback : public titleformatting_variable_callback
{
public:
   void on_var_change( const char * var )
   {
      console::printf( "sample_callback: %s", var );
   }
};
service_factory_single_t<sample_callback> g_sample_callback;