irs.py | ||
LICENSE | ||
README.md | ||
requirements.txt |
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
- 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.