AutoRipper v1.1.2
Author: Squeezyb
Changelog: https://www.autoripper.shop/changelog

=========================
Patreon "AutoRipper Fans"
=========================

- Rudy Amaya

Huge thank you for pledging an extra $10/month to AutoRipper!

Support the project at: https://www.patreon.com/c/Squeezyb

=========================
Requirements
=========================

AutoRipper depends on external tools for ripping, encoding, and renaming. Please download and install the following:

- **MakeMKV**
  Required for disc ripping
  https://www.makemkv.com/download/

- **HandBrake**
  Required for video encoding
  https://handbrake.fr/downloads.php

- **HandBrakeCLI**
  Required by AutoRipper — download from:
  https://handbrake.fr/downloads2.php

- **FileBot**
  Required for renaming and organizing files
  https://www.filebot.net/#download

- **MPV**
  Required for previewing titles before ripping
  https://mpv.io/installation/

- **MKVMerge**
  Required for selecting audio/subtitle tracks
  https://mkvtoolnix.download/downloads.html

NOTE:
AutoRipper does **not** include these tools. You must install and license them separately where required.
AutoRipper is simply a frontend for these programs. It is not a standalone ripper or re-encoder.

=========================
Setup Instructions
=========================

Setup instructions are separated by operating system.

Please read the appropriate file before running AutoRipper for the first time:

-Windows Setup Instructions.txt.
-MAC Setup Instructions.txt
-Linux Setup Instructions.txt

These files cover tool installation, permissions, PATH configuration, and verification steps.

=========================
Ripping a TV Show
=========================

1. Insert the disc and wait for the OS to detect it. Hit refresh if the disc was inserted after AutoRipper was opened or if it was only partially loaded. Properly scanned discs will be at the top of the list.

2. Select your disc drive.

3. Choose **TV Show** mode.

4. Title, Season, and Disc # will be automatically loaded based on the disc title when possible. Double check that the information is correct.

5. Optional: Fill in the DVDCompare field if DVDCompare.net data exists for the disc. When provided, AutoRipper will use DVDCompare runtimes to improve episode detection and ordering.

6. Enter starting and ending episode #. Example: Disc 1 has Episodes 1 through 5. Starting Episode would be 1 and Ending Episode would be 5.

7. Optional: Check "Transcode" and choose a HandBrake preset.

8. Click **Start**.

The app will:

- Automatically scan for valid episode titles
- Detect the correct episode order using runtime and chapter based matching
- Rip each episode to the TEMP folder
- Automatically retry disc reads up to 3 times if temporary read errors occur
- Automatically eject the disc after ripping
- (If enabled) Transcode the episodes in the background
- (If enabled) Rename and organize them using FileBot
- Move them to your final TV Show folder

NOTE:
Even without FileBot, episode names will be "Title - SxxEyy.mkv".

TV discs that contain multiple episodes combined into a single title can be marked as 2 part episodes. These will be named as "Show Name - SxxEyy-Ezz.mkv" and are correctly detected by FileBot, Plex, and Jellyfin.

=========================
Ripping a Movie
=========================

1. Insert a movie disc.

2. Choose **Movie** mode.

3. Enter the movie title and year.

4. Optional: Check "Transcode" and select a HandBrake preset.

5. Click **Start**.

The app will:

- Rip the longest title on the disc
- Automatically retry disc reads up to 3 times if temporary read errors occur
- Automatically eject the disc after ripping
- (If enabled) Transcode the movie in the background
- Rename and organize it using FileBot
- Move it to your final Movies folder

=========================
Telegram Notifications
=========================

1. In AutoRipper Settings, click 'Setup' in the bottom left corner.

2. In Telegram, search 'BotFather' and start a new chat.

3. Send " /newbot ".

4. Choose a name (E.g. AutoRipperNotifications).

5. Choose a bot name (E.g. AutoRipperNotify_bot).

6. Copy the Bot Token it gives you and paste it into AutoRipper's Telegram Notification Setup page.

7. Send " /start " to your new bot chat.

8. Click 'Get Chat ID' in AutoRipper's Telegram Notification Setup page.

9. Check 'Enable Telegram Notifications' in AutoRipper's Telegram Notification Setup page.

10. Click 'Test Connection' and verify that it sends you a message on Telegram. This will send to your mobile device or another computer if you are signed into the same account.

11. Click 'Save' to store your Telegram Bot Token and Chat ID.

=========================
File Naming
=========================

AutoRipper uses FileBot to name files like:

TV Shows:
Show Name/Season 5/Show Name - S05E03 - Episode Title.mkv

Otherwise, it reverts to:
Show Name/Season 5/Show Name - S05E03.mkv

Movies:
Movie Title (2005).mkv

=========================
Things to Note
=========================

* Regardless of HandBrake preset selected, AutoRipper keeps all subtitle and audio files unchanged. This was simpler and more effective than trying to select which audio formats or languages to keep since every disc is different.

* For ripping multiple discs at once using separate drives, hit the **New Window** button and select the disc you want to rip. Transcodes from separate windows will still go into the transcode queue in the order that rips complete.

=========================
Licensing Notes
=========================

AutoRipper does not include or redistribute any third party software.
You are responsible for downloading and licensing MakeMKV, HandBrake, and FileBot.

MakeMKV: Free while in beta, paid license available
HandBrake: Open source
FileBot: Requires a paid license
MPV: Open source
MKVToolNix: Open source

=========================
Contact / Updates
=========================

Email:support@autoripper.shop

Check for updates or leave feedback at: https://forums.autoripper.shop/

Thank you for supporting this project!
