HardLinker Explained

HardLinker: Mastering Media Management Through Smart Automation

Managing a growing digital media library can quickly become a chaotic chore. Between downloading new content, organizing files for media servers like Plex, Emby, or Jellyfin, and trying to save precious hard drive space, users often find themselves trapped in a loop of manual file management. Enter HardLinker, an open-source automation tool designed to bring order to media chaos using the power of hard links. What is HardLinker?

HardLinker is a specialized software utility that automates the process of organizing media files. It sits between your download client (like Qbittorrent or Transmission) and your media server library.

Instead of moving or copying files—which either breaks your torrent seeding or doubles your storage consumption—HardLinker creates hard links. This allows a single file to exist in two different folders simultaneously without using any extra disk space. Key Features

Zero-Space Duplication: Create media server-friendly folder structures without duplicating multi-gigabyte files.

Automated Renaming: Parse complex release titles into clean, recognizable movie and TV show formats.

Seeding Integrity: Keep your original downloaded files exactly where they are to ensure uninterrupted torrent seeding.

Smart Monitoring: Scan incoming folders automatically and sort new content the moment a download finishes. The Magic of Hard Links vs. Soft Links

To understand why HardLinker is so effective, it helps to understand the underlying technology:

[ Physical Data on Hard Drive ] ▲ ▲ │ │ [ Download Folder ] Media Server Folder (Clean Renamed File)

Symbolic Links (Soft Links): These are mere shortcuts. If you delete or move the original file, the shortcut breaks.

Hard Links: These point directly to the physical data on the hard drive. The operating system views them as two entirely independent files. You can edit, rename, or delete the file in your download folder, and the file in your Plex library remains completely intact and functional. How HardLinker Transforms Your Workflow 1. The Traditional Problem

Normally, when you download a video file, it arrives with a messy name full of tags, release groups, and technical specs (e.g., Movie.Title.2024.1080p.BluRay.x264-Group). If you rename it for Plex, your torrent client stops seeding. If you copy it to rename it, you use twice the storage space. 2. The HardLinker Solution

HardLinker watches your download directory. When a file completes, it analyzes the metadata, creates a hard link in your media library directory, and renames that link cleanly (e.g., Movies/Movie Title (2024)/Movie Title (2024).mp4).

Your torrent client keeps seeding the original file, your media server perfectly indexes the new link, and your hard drive usage does not increase by a single megabyte. Getting Started

HardLinker is typically deployed via Docker, making it highly compatible with Network Attached Storage (NAS) devices, Unraid, TrueNAS, and home servers.

Deploy the Container: Set up the HardLinker Docker container alongside your media stack.

Configure Paths: Ensure both your download directory and media directory reside on the same physical hard drive partition (a requirement for hard linking).

Set Sorting Rules: Define how you want your TV shows and movies structured.

Run and Automate: Let the software run in the background to handle every subsequent download automatically. Conclusion

HardLinker bridges the gap between raw data acquisition and elegant media presentation. By leveraging the native file system capabilities of Linux and Windows, it eliminates the compromise between maintaining a healthy torrent seed ratio and keeping a pristine media catalog. For anyone serious about self-hosting a media server, HardLinker is an essential piece of infrastructure.

If you want to set this up for your own home server, let me know:

What operating system or NAS platform you are using (e.g., Unraid, Ubuntu, Synology) Which download client and media server you need to connect

I can provide a tailored Docker Compose configuration to get you up and running.