How to Make UYKFD Do Something

UYKFD can be made to take some action by specifying a command. There are two ways to give a command:

1. On the command line when running the program. The command is executed and the the program finishes.
2. By starting the program with no command. You will then be prompted for a series of commands. The program continues running until it crashes or you type "exit", "quit" or Ctrl-D.

The following commands are available:

• quit, exit, Ctrl-D - see above.
• show properties, set name value- see Properties.
• show lastfm artist name tags - list tags and weights for an artist
• show lastfm artist name connections - list neighbours and weights for an artist.
• show lastfm artist name backlinks - show backlink data for an artist.
• export dir, import dir - save data to disk. if you understand the schema, you can delete some tables and so, for example, avoid calling Last FM when re-reading MP3s. This is also useful when updating schema (export; exit; delete database; start; import).
• logging debug/info/warn - set the logging level for Empire DB.
• read mp3s path - read mp3s on the given path.
• read lastfm artists - read artist tags from Last FM.
• build auto - this takes a long time, but generates a better distance measure than the approaches below.
• walk lastfm artist artist count backlinks - generate a list of files

For normal use, execute the commands in bold, in the order given. Parameters are in italics and should be "quoted" if they contain spaces.

All output goes to stdout except the list of files generated during a walk. So to generate a playlist interactively run the program with stderr directed to a file.

Older Instructions

The build all command (see above) gives best results, but feel free to play with these if you're curious.

• build lastfm artist connections - infer the connections between artists from the Last FM tags.
• build lastfm artist connection distances - calculate distances between artists given the connections.
• walk lastfm artist artist count connections - generate a list of files starting with a track from a neighbour of the given artist and then moving to a related artist's track.
• build lastfm artist backlinks - infer a graph of artist relationships based on "who links back".
• build lastfm artist backlink distances - calculate distances between artists given the backlinks.
• walk lastfm artist artist count backlinks - generate a list of files (alternative algorithm).