jellyzen.sh

JellyZen Ultra is a powerful Bash-based automation tool for Linux-based Jellyfin servers. It transforms cluttered, disorganized Series and Movie collections into a perfectly structured, scannable format, including optional hardware-optimized transcoding.

---

🚀 Key Features

• Smart Recursive Restructuring: Automatically detects show names and seasons (Arcs), no matter how deep the files are buried.
• Advanced Episode Detection: Robust regex engine that finds episode numbers while ignoring resolutions (720p/1080p) and codec tags (h.264/h.265).
• Special Folder Support: Automatically moves "DVD Extras," "Movies," or "Filler" folders into Season 00 (Specials), mapping them correctly to the main series.- Dual Mode:
  • --mode series: Tailored for Anime/TV shows using SxxExx logic.
  • --mode movies: 1:1 renaming based on the parent folder name for feature films.
• Conversion Engine: Integrated FFmpeg support for mp4, hevc, and mpeg2.
• Safety First: Detailed --dry-run simulation mode and an interactive confirmation prompt before any real changes occur.
• Logfile Creation Advanced date based logging via --log <dir>.
• Auto-Cleanup: Skips hidden Apple resource fork files (._*) and automatically deletes empty Arc folders after a successful move.

---

🛠 Installation1. Clone the repository:

 git clone https://github.com/suuhm/jellyzen.sh
 cd jellyzen.sh

1. Make the script executable:

chmod +x jellyzen.sh

2. (Optional) Make it globally available:

sudo ln -s $(pwd)/jellyzen.sh /usr/local/bin/jellyzen

---

📖 Usage

Basic Command (Simulation)

It is highly recommended to always run with -t or --dry-run first to preview the changes.

./jellyzen.sh --dir /media/Anime/Bleach --mode series --dry-run

Real Run (Move & Rename)

./jellyzen.sh --dir /media/Anime/Bleach --mode series

Conversion to MP4 (H.264)

./jellyzen.sh --dir /media/Anime/One_Punch_Man --mode series --convert mp4

Movie Mode

./jellyzen.sh --dir /media/Movies/Zombieland --mode movies

---

📂 Supported Folder Structures

JellyZen understands complex nesting out of the box: Input:

/Anime/Bleach/
├── 1. Agent of the Shinigami arc/
│   └── Beach_001.avi
└── DVD Extras/
    └── Omake DVD 01.mkv

JellyZen Output:

/Anime/Bleach/
├── Season 01/
│   └── Bleach - S01E001.avi
└── Season 00/
    └── Bleach - S00E001 - Omake DVD 01.mkv

---

⚙️ Options

Option	Short	Description
--dir	-d	Target directory of your media.
--mode	-m	series (Default) or movies.
--dry-run	-t	Simulation mode, no changes to disk.
--convert		mp4, hevc, or mpeg2.
--log	-l	Path to a log file or folder.
--version	-v	Display version info.
--help	-h	Display the advanced help page.

---

⚖️ License

Distributed under the MIT License. See LICENSE for more information. (c) 2026 by suuhm