irs/README.md

3.3 KiB

The Ingenious Redistribution System (IRS)

Downloads or streams media from the name of the song / album / movie / tv-show that you requested.

Dependencies

First, actually install python and pip:

  • To install python3 and pip for Ubuntu run this command:
$ sudo apt-get install python3 python3-pip
  • For Windows follow this guide to install python (remember to install ~v3.4), and this guide to install pip.
  • For OSX follow this guide that goes through python and pip. Also, remember to install ~v3.4.

Then install requirements.txt from the repository:

$ python install -r requirements.txt

There are some more external command-line programs that are essential to movies, tv-shows, and streaming:

$ sudo apt-get install rtorrent
  • mpv: https://mpv.io/installation/
  • Peerflix:
    • Windows: follow this guide to install npm and then run this command:
    $ npm install -g peerflix
    
    • OSX: Same as Windows, except follow this guide.
    • Ubuntu: Again, the same, only follow this guide instead.
  • VLC: Just download and install it here.

Install

$ git clone https://github.com/kepoorhampond/IngeniousRedistributionSystem.git

And that should be it! Eventually it'll be put up on pip, to make it much, much easier to install.

Overview

Currently the system can stream or download the following:

  • Specific songs.
  • Complete albums.
  • Movies.
  • TV shows.
  • Playlists.
  • Comics and books.*

* Limited only to downloading.

When downloading music, the system will fill out the specific meta-data so that it will appear organized in your player of choice. It parses the following pieces of meta-data:

  • Title.
  • Artist.
  • Album.
  • Album cover/art.*
  • Year released.
  • Tracknumber.*

* Album art is slightly buggy, and tracknumber only works when downloading complete album.

On a personal judgement, we would say that the complete meta-data parsing works ~80% of the time.

Usage

$ irs (stream | download) movie <movie-name>
$ irs (stream | download) tv <tv-show> <episode>
$ irs (stream | download) (song | album) <title> by <artist>
$ irs (stream | download) playlist <txt-file-name>
$ irs download (comic <title> <run> | book <title> by <author>)

Examples

$ irs download book I, Robot by Isaac Asimov
$ irs stream song Where Is My Mind by The Pixies
$ irs download album A Night At The Opera by Queen
$ irs stream movie Fight Club
$ irs download tv mr.robot s01e01
$ irs stream playlist "Rock Save The Queen.txt"
$ irs download comic Paper Girls 001

The text file should be formatted like so: <song>: <artist>

Good Times Bad Times: Led Zeppelin
I Want To Break Free: Queen
The Man Who Sold The World: David Bowie

Disclaimer

Copyrighted content may be illegal to stream and/or download in your country.