# FileBot

FileBot is a long-standing tool for renaming and organising media files. It looks each file up against TheMovieDB, TheTVDB, AniDB and other sources, then renames and files it the way [Plex](</app/plex/>), [Jellyfin](</app/jellyfin/>) and Emby expect (*folder per film, season folders, episode numbers, specials, multi-episode files, absolute numbering for anime*), so your media server matches everything first time. Its format expressions let you design any naming scheme you like.

ElfHosted runs **FileBot Node**, FileBot's own web interface: you pick an input folder in your storage, choose options, and run FileBot's automated media-centre script on it, or save that as a task to run again later.

**When does hosted FileBot make sense?**

- **Your library is in cloud storage.** FileBot runs next to your [rclone-mounted storage](</how-to/use-rclone/>), so renaming an old library doesn't mean pulling it down to a home computer first.
- **No Java to keep running.** FileBot needs a Java runtime; on ElfHosted it's in the image and updated for you.
- **Behind your ElfHosted login.** FileBot Node has no login of its own here; your ElfHosted sign-in protects it.
- **Your licence and settings are kept.** FileBot keeps its licence and settings in your `config/filebot` folder, which survives restarts and updates and is covered by your nightly volume backup.

> [!WARNING]
>
> **You need your own FileBot licence**
>
> FileBot is commercial software and needs a paid licence from [filebot.net](<https://www.filebot.net/purchase.html>). Your ElfHosted subscription covers hosting only; it doesn't include or manage a FileBot licence. Until you install one, FileBot won't process files.

[Get a 7-day trial of ElfHosted FileBot! 🪄](<https://store.elfhosted.com/product/filebot/>)

## How do I access FileBot?

FileBot is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-filebot.elfhosted.com](<https://your-username-filebot.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/filebot/>) and these become your personal, clickable links.

## How do I use it?

### 1\. Install your licence

Buy a licence at [filebot.net](<https://www.filebot.net/purchase.html>); you'll receive a licence file. Open FileBot from your dashboard and use **Tools → License** to install it. It's stored in your `config/filebot` folder, so you only do this once.

### 2\. Find your folders

FileBot sees your ElfHosted storage under `/storage`. Once you've [mounted your own cloud storage](</how-to/use-rclone/>), it appears in `/storage/rclone/<something>`; use [FileBrowser](</app/filebrowser/>) to confirm the exact path. Decide on an input folder (*what to rename*) and an output folder (*where your media server's library lives*).

### 3\. Do a dry run first

In FileBot Node, pick the input folder, set the output folder, and choose the **test** action, which shows what FileBot would do without touching a file. When the names look right, run it again with **move** (*or **copy** to keep the originals*).

### 4\. Point your media server at the output

Add the output folder as a library in [Plex](</app/plex/>), [Jellyfin](</app/jellyfin/>) or Emby, or refresh the library if it's already there.

### Repeat jobs

Save a configured run with **Execute → Schedule** to get a reusable task. Upstream's remote trigger (`/task?id=...`) sits behind your ElfHosted login on ElfHosted, so scripts outside your account can't call it.

> [!TIP]
>
> **Renaming cloud storage is slower than local disk**
>
> A move within the same cloud remote is usually a quick rename; a move between remotes, or a copy, transfers the whole file. Start with a small folder to see how your storage behaves.

## FileBot also works with

- [x] [Plex](</app/plex/>)
- [x] [Jellyfin](</app/jellyfin/>)
- [x] [Emby](</app/emby/>)
- [x] [FileBrowser](</app/filebrowser/>)

## How do I get support for FileBot?

1. For general use of FileBot, refer to the [official site](<https://www.filebot.net>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## FileBot resources

- [FileBot (*official site*)](<https://www.filebot.net>)
- [FileBot FileBot Node](<https://github.com/filebot/filebot-node>)
- [FileBot Docker images and licence FAQ](<https://github.com/filebot/filebot-docker>)
- [FileBot Format expressions](<https://www.filebot.net/naming.html>)
