Up2Date-0.95.2

Up2Date 0. ABOUT 1. INSTALLATION 2. USAGE 3. RESOURCES 4. VIEWS 5. INPUTS 6. CONTACT 0. ABOUT Up2Date is a tool written for myself by myself which I used to find music albums I should get. I tend to listen to similar music but I don't always know when an artist I like releases a new album. I made this tool to compare my current list of albums to an online source to see if there are any albums I'm missing. After writing this tool I realised that others might find it useful so I cleaned up the code, wrote this file and released it. 1. INSTALLATION This requires PHP 5 installed to work, and you need to be able to run php files from the terminal/command line. On Microsoft Windows you'll need PHP 5.3.0 as getopt() is used, this version of PHP is currently not stable. You'll also need to make the main .php executable: chmod +x Up2Date.php This tool also assumes an organised music folder as follows: Artist/Album/... For example: Music/ |-- Foo Fighters | |-- Echoes, Silence, Patience And Grace | |-- The Colour And The Shape | `-- There is Nothing Left to Lose |-- Guano Apes | |-- Don't Give Me Names | |-- Proud Like A God | `-- Walking On A Thin Line `-- Yeah Yeah Yeahs |-- Fever to Tell `-- Show Your Bones Actually this structure is only required by the 'inputs' I myself have created, if someone created one which reads the meta data from the tracks and builds up the structure that way I'd love that. 2. USAGE This is written as a command line program, but the idea is that it can easily be adapted to be used as a web based application. As it stands make sure you make the file Up2Date.php executable. Running Up2Date without any parameters will give you all the options you can supply: Up2Date 0.95.4 -r resource_name The name of the resource to use [=azlyrics_com] -v view_name The name of the view to use [=cli] -i input_name The name of the view to use [=filesystem] -f input The path to the file/folder which contains the input [required] -h help Shows you this help message The most basic way to run the program is: Up2Date.php -f /path/to/music/ Up2Date will pick the default values for the rest of the options for you. If you want to pick a custom input_name, for instance, that is done like this: Up2Date.php -f /some/to/tree-output -i unixtree Parameters can go in any order, in fact, normal parameter rules apply 3. RESOURCES The "resource_name" signifies which class from the 'resources' folder gets loaded, different resources will load data from different locations. The provided resources are music_msn_com (which loads the data from music.msn.com) and azlyrics_com (which loads data from azlyrics.com). Each resource will be different, while music.msn.com may have a broader range of music is also slower to access (as it requires 2 round trip times (RTTs) per artist) whereas azlyrics.com only requires one RTT per artist but may have a smaller range of artists. The default is azlyrics_com. 4. VIEWS The "view_name" signifies how the program will output the resulting data. The provided views are cli and xml. The former will output the data in a newline separated and indented list ideal for reading in the terminal or piping to a text file. The xml view outputs the data into an xml file, will suited for later parsing by other programs. All views output the data to STDOUT, it is assumed the user will pipe the ouput as required. 5. INPUTS This 'input_name' signifies what format the program takes the input in. The provided inputs are filesystem, unixtree and wintree. Each input has one parameter passed to it, the required -f parameter, what this parameter should point to varies depending on what input was specified. The filesystem input expects the -f value to point to your local music folder, filesystem will then scan that folder for the data it will use. unixtree and wintree both expect the -f value to point to a file containing the ouput of the 'tree' command (either the windows or the unix version) when run on your music folder. The default input is filesystem. 6. CONTACT You can contact me, Sid, at [email protected] /* */

udp://tracker.openbittorrent.com:80
udp://open.demonii.com:1337
udp://tracker.coppersurfer.tk:6969
udp://exodus.desync.com:6969