mp3get is a command-line application to download mp3s that are available scattered somewhere in the web. It started as an experiment and it took 1 day of coding to get it working (version 0.1) and 1 day of cleanup to get a decent code.

(Thanks to Jeff Dehut of http://www.explosivelimes.com for the "icon", it doesn't have much to do with getting mp3s but I liked it)

Support

Like this software? You can join the project and improve it! Check the Developer's Corner. That would be great because I can't assure that I'll support it forever.

Like this software? Help make this software better! click here to donate! and make me happy :)

Warranty

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Requirements

• Python installed (has been tested with version 2.5.1)
• Any OS that supports Python should work

Download

Actual version: 0.1 (download).

Screenshots

Debug HTML

Version History

Version 0.1

• Initial release.

Known bugs

See issues.

User Guide

Run as

mp3get.py <artist> <title>

if you want to download a specific track or

mp3get.py -f <file>

if you have a file where the tracks are listed as "Track Name - Artist Name", one line each.

The application will search and download the tracks (or at least do the best it can).

Tip: Use quotes if the artist or track contains a space, e.g.

mp3get.py "Bob Dylan" "Like a rolling stone"

Full usage output:

Usage:
  ./mp3get.py [options] <artist> <title>
  ./mp3get.py [options] -f <file>
Options:
  -d              Generates debug.html with very interesting debug information.
  -t <threshold>  Sets the accepting threshold (default: 0.7).

Developer's Corner and Documentation

TODOs/Ideas

• Make a better track-match distance function.
• Handle criteria ordering via a lexicographic order.
• Make more plugins for different sites.
• Make a plugin to parallelize search and downloads.
• Give the option to NOT download the files and just output the URLs.