Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update instructions for installation in README.md #26

Merged
merged 1 commit into from
Nov 8, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 16 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,17 @@ Occasionally holds random useful scripts as well.
These scripts are designed to enhance functionality, improve management, and automate routine tasks.
All scripts are **Created By: [Bakerboy448](https://github.com/bakerboy448/) unless otherwise noted.**

**Warning**: Do not edit files on Windows that will be executed on Linux without ensuring the line-endings are set to `LF`.
This means that `CRLF` cannot be used in .sh scripts. Bash scripts will not execute properly and you will receive an
error.

## Scripts Overview

### Cross-Seed Category Filter for Qbittorrent

- **Script:** `xseed_qbit_cat_filter.sh`
- **Description:** Filters cross-seed requests by categories or trackers for execution by Qbittorrent.
- **Instructions:** Open the file in a text editor and modify the variable definitions at the top of the script, then replace the "Execute on completion" command in qBittorrent with the one given in the notes at the top of the script.
- **Creator:** [zakkarry](https://github.com/zakkarry)
- **Usage:** Execute the script to filter categories or trackers as needed in Qbittorrent setups.

Expand All @@ -19,10 +24,13 @@ All scripts are **Created By: [Bakerboy448](https://github.com/bakerboy448/) unl
- **Script:** `xseed.sh`
- **Description:** Triggers a cross-seed search post-import or post-upgrade in Starr applications.
- **Creator:** [Bakerboy448](https://github.com/bakerboy448/) with assistance from [zakkarry](https://github.com/zakkarry)
- **Setup**
1. Copy `.env.sample` to `.env`.
2. Populate required values under "# Xseed" header.
3. Docker Users: Mount `.env` and `xseed.sh` to your Starr's `/config` mount.
- **Instructions**
1. If using environmental variables file, copy `.env.sample` to `.env`.
2. If not using `.env`, open the script in a text editor and modify the required values under "# Xseed" header.
3. Ensure that your download client's _NAME_ in the Download Client section of the respective \*arr match the variables in the script.
4. Docker Users: Mount `.env` and `xseed.sh` to your Starr's `/config` mount.
5. In your \*arr, navigate to `Settings` -> `Connect` and add a "Custom Script" for the "On Import Complete" for Sonarr and "On File Import" and "On File Upgrade" for Radarr.
6. Test and Save.

### Cross-Seed Updater

Expand All @@ -33,7 +41,7 @@ All scripts are **Created By: [Bakerboy448](https://github.com/bakerboy448/) unl

- **Script:** `dupe.sh`
- **Description:** Executes `jdupes` to find and manage duplicate files in the specified directory.
- **Setup:**
- **Instructions:**
1. Copy `.env.sample` to `.env`.
2. Populate required values under "# Jdupes" header.
3. Review and adjust script parameters to fit your use case.
Expand All @@ -49,7 +57,7 @@ All scripts are **Created By: [Bakerboy448](https://github.com/bakerboy448/) unl
- **Error Handling:** Captures and logs errors during the merging process, ensuring reliable operations.
- **Detailed Logging:** Tracks and logs every file and directory operation, providing clear visibility into the process.
- **Usage Case:** Ideal for consolidating data in scenarios like organizing media libraries, merging data backups, or simplifying file system structures.
- **Setup:**
- **Instructions:**
1. Update `source_dirs` and uncomment the variable
2. Update `target_dir` and uncomment the variable
3. Uncomment `atomic_moves` to engage the movement operation
Expand Down Expand Up @@ -77,7 +85,7 @@ All scripts are **Created By: [Bakerboy448](https://github.com/bakerboy448/) unl

- **Script:** `qbm-qbit.sh`
- **Description:** Executes [QbitManage](https://github.com/StuffAnThings/qbit_manage) upon download completion in Qbittorrent.
- **Setup:**
- **Instructions:**
1. Copy `.env.sample` to `.env`.
2. Populate required values under "# Qbittorrent Manage" header.

Expand All @@ -96,7 +104,7 @@ All scripts are **Created By: [Bakerboy448](https://github.com/bakerboy448/) unl

- **Script:** `zfsburn.sh`
- **Description:** Deletes ZFS autosnapshots older than a specified number of days.
- **Setup:**
- **Instructions:**
1. Copy `.env.sample` to `.env`.
2. Fill in the required values under "# ZFS Destroy" header.

Expand Down