https://github.com/m0mosenpai/umaru-chan

Automate anime watching, downloading and managing on Windows/Linux
https://github.com/m0mosenpai/umaru-chan

anime myanimelist nyaa python3 scrapy torrent-files webscraping

Last synced: about 2 months ago
JSON representation

Automate anime watching, downloading and managing on Windows/Linux

• Host: GitHub
• URL: https://github.com/m0mosenpai/umaru-chan
• Owner: m0mosenpai
• License: mit
• Created: 2020-01-21T18:05:38.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2022-11-04T19:40:13.000Z (about 2 years ago)
• Last Synced: 2023-03-04T03:20:04.043Z (almost 2 years ago)
• Topics: anime, myanimelist, nyaa, python3, scrapy, torrent-files, webscraping
• Language: Python
• Homepage:
• Size: 46.1 MB
• Stars: 8
• Watchers: 1
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
*** This project was made with the intent of learning and by no means promotes piracy or illegal distribution of copyrighted content. We wanted to learn as well as have fun/ be motivated while doing so and anime was just one of the things we were passionate about and so, wanted to make something related to it. ***

# Umaru-chan

A program to automate anime watching and downloading from [nyaa.si](https://nyaa.si/) based on release schedule. 


*The program scraped Schedule and Seasonal data from HorribleSubs and since the website has shutdown, part of the code has to be re-written. This will take some time and hopefully, we can make the program more future-proof this time.*

## Description

The program is built particularly for seasonal anime watchers - people who watch weekly episodes of new shows every season. If you are not one of those people and just want to automate downloading shows in bulk, use the `-d/--download` parameter (Read below for more info)

## Installation

Clone this repository using: 


`git clone https://github.com/m0mosenpai/Umaru-chan.git`


Create a virtual environment, preferably in Anaconda (pip might cause some issues in some windows machines), and run requirements.txt to install all dependencies


`pip install -r requirements.txt`


Run install.py and follow the prompts on screen.



Enable `Automatically add .torrent files from ` in your torrent client - set the `` to the ``(set using -`t/--torrent`. Read usage below for more info) (**IMPORTANT**)(This is a one time setup)


Leave the torrent client running in the background.

![img](https://i.imgur.com/oniK2K9.png)

## Usage

* `umaru.py` allows you to set up various default parameters for your program:


  * `-p/--path ` - Default anime storage libarary (Where you store all your anime files)

  * `-t/--torrent ` - Default download directory for .torrent files (This is where .torrent files will be downloaded)

  * `-q/--quality ` - Sets download quality for all episodes.(480p/ 720p/ 1080p)

  * `-a/--add :` - Adds one or more shows to your watchlist.

  * `-l/--list` - Displays your current locally saved watchlist.

  * `-r/--remove ` - Removes one or more shows from the watchlist.

  * `-cl/--clr-list` - Clears watchlist.

  * `-cc/--clr-config` - Resets Config. (Use this if you encounter any JSON Decoding errors).

  * `-s/--status` - Displays all your set values and server status (if running)

  * __**__`-m/--mal-id  ` - Sets MyAnimeList user and pass for automated list updation.

  * `-w/--watch` - Watch anime in your set PATH (from `-p`)

  * `-d/--download  ` - Download any anime in bulk in range START-END from nyaa/HS (This is to download any show separately if you don't care/don't watch shows regularly on a weekly basis every season)

  * `-e/--execute` - Runs the main scraper/server which downloads the anime.

  

  ** __Password is stored locally in plaintext form.__ 


  

  ![img](https://i.imgur.com/rPNlb1k.png)

  

  

* Run `umaru.py -e` once a day (or set it up to run on startup) and it will automatically download the .torrent files based on release schedule and your watchlist, and store them in T_PATH (Set up using `-t/--torrent` parameter). On days when none of the shows in your watchlist air, it will simply exit.


From there on, your torrent client will download all the episodes from the .torrent files.



**IMPORTANT**: Make sure the download directory set in the torrent client is same as the PATH set using `-p/--path` (PATH to your anime library)

![gif](media/umaru_downloading.gif)

And that's it! To watch your download anime, run `umaru.py` with `-w/--watch` or if you want to download a show that's not airing this season, use `-d/--download`.


### Automatic List Updation

Umaru-chan also supports automatic media detection and list updation. Run `media_detect.py` and set up MAL login credentials and it'll automatically detect which anime you are watching and update your list when you finish the episode. Most common file formats and media players are supported. Note that it only detects few supported media players by default. (Read below for other unrecognized media players).

### Automatic Media Player Detection

Open a media file with the player of your choice and run `autofind.py` to automatically detect the player and save it to the list of recognized media players processes. This is useful if a media player is not recognized by `media_detect.py` by default.

![gif](media/umaru_updating.gif)

# Authors

Sarthak Khattar @[m0mosenpai](https://github.com/m0mosenpai) 


Ayush Singh @[prog-butter](https://github.com/prog-butter)

# License

MIT