Command Line Usage

Use a command line terminal

• Open a terminal like Windows Command Prompt.

Change directory to library_finder

• Make sure you are on the drive containing library_finder (Windows only):
  • Type C: and hit enter.
  • Terminal will look like: C:\Users\JP> where "JP" is your username.
• Change directory to where library_finder is installed:
  • Windows
    • Type cd C:\Program Files\library_finder and hit enter.
    • Type dir and hit enter; you should see library_finder in the list.

Try a command

• Type library_finder --help followed by enter to see a quick reference.
• Scan for libraries:
  • Enter library_finder C:\Users\JP\Music where "JP" is your username.
    • Note that this is intended to be a quick test run - if your user account folder contains a massive music library then this command may take some time to complete and you may rather try the command on a different subfolder.

Interpreting output

By default the output printed to the terminal will display a file directory tree indicating how many tracks and albums are to be found under each directory. In this example the command library_finder Y: we see that Y: contains 8242 tracks in 787 albums. Looking further down we can confirm that Y:\Music is a Music Library containing 7878 tracks in 755 albums, a significant portion of the overall search. As we look through the Y:\Music library we can see that there is potentially a sub-library at Y:\Music\DJ Tracks that contains 946 tracks in 106 albums.

\Y: - contains 8242 tracks in 787 albums
    \Movies - contains 179 tracks in 10 albums
        \Afro.Samurai-The.Complete.Collection.MemoryWipe - contains 42 tracks in 2 albums
        \Halloween - contains 137 tracks in 8 albums
    \Music - contains 7878 tracks in 755 albums
        \Aqua - contains 117 tracks in 9 albums
        \Beatles ALAC - contains 261 tracks in 18 albums
            \Videos - contains 261 tracks in 18 albums
                \The Beatles - Stereo and Mono Box Sets + Extras [FLAC] - contains 226 tracks in 16 albums
                    \The Beatles Stereo Box Set - contains 226 tracks in 16 albums
                        \The Beatles - Past Masters [2009 Stereo Remaster] - contains 33 tracks in 2 albums
                        \The Beatles - The Beatles (White Album) [2009 Stereo Remaster] - contains 30 tracks in 2 albums
                \The Essential Sly & The Family Stone [2011] - contains 35 tracks in 2 albums
        \Bob Dylan - contains 161 tracks in 19 albums
            \2 - Live Albums - contains 1 tracks in 1 albums
            \3 - Bootleg Series - contains 58 tracks in 3 albums
                \12E968~1 - contains 58 tracks in 3 albums
        \Creedence Clearwater Revival - contains 99 tracks in 8 albums
        \DILT - contains 1 tracks in 1 albums
        \DJ Tracks - contains 946 tracks in 106 albums
            \Breakcore - contains 57 tracks in 5 albums
            \Frenchcore Hardtek 8-18-16 - contains 4 tracks in 1 albums
            \Hardcore Breaks - contains 28 tracks in 4 albums
                \4-1-2017 hardcore breaks sorting - contains 28 tracks in 4 albums
            \KFA - contains 277 tracks in 40 albums            

This format can be cumbersome to wade through which is why you will probably want to use it just for verifying subfolders that you suspect are libraries or to catch albums that may have strayed to the wrong save location. For more comprehensive searches you will want to use the --html flag and view the results with a browser.

A more thorough search using library_explorer

library_finder is intended to be run on the root of drives.

• library_finder C: --tolerance 50 --html
  • --tolerance 50 allows for there to be up to 50 non-target file types (eg not audio) before the folder is discounted as a potential album. The higher the tolerance the longer library_finder will take to complete. Default tolerance is 2.
  • --html directs the output to an HTML file to be opened with browser rather than printing the results to the terminal.