Ritobin

Convert League .bin files to readable text and back with Ritobin by Moonshadow. Drag-and-drop guide for skin creators.

Ritobin is a tool by Moonshadow that converts League's .bin files into readable text you can edit, then converts them back. Older than Jade, still solid for batch jobs and scripts.

The latest Windows build is on GitHub: ritobin releases.

Use Jade instead for most edits

Jade is the newer workflow. It edits .bin files visually with syntax coloring, hover previews, and live hash lookups. No converting back and forth. Pick Ritobin only if you need batch scripts or you're already comfortable with the text workflow.

What you need before you start

A Windows PC.
The latest ritobin.zip from the releases page.
A .bin file from a skin you want to edit.

Install

Download ritobin.zip from the latest release.
Make a folder for Ritobin and your .bin files.
Extract the zip into that folder.

Warning

Keep the hashes folder in the same directory as ritobin_cli.exe and ritobin_gui.exe. If the hashes go missing or move, conversions fail.

This hashes folder is for Ritobin only

Ritobin needs its own local hashes folder. Not every tool works this way. Flint and Quartz auto-fetch a prebuilt hash database and need no folder. Only older tools like Ritobin and standalone Jade use this manual CommunityDragon folder model.

Convert files

Convert `.bin` to `.py`

Make a desktop shortcut for ritobin_cli.exe.
Drag the .bin file onto the shortcut.

A .py file appears next to the original. This is a readable version of the .bin you can edit.

Open the `.py` file

You need a text editor or IDE to edit it. The file is plain text, not real Python, so any editor works:

Visual Studio Code is free and has Python syntax coloring out of the box. Best pick if you don't already have an editor.
Notepad++ is lighter weight. Good for quick edits.
Any other code editor or IDE works too.

Save your changes, then move to the next tab to convert it back.

Convert `.py` back to `.bin`

Once you've edited the .py file and want to test it in-game:

Drag the edited .py file onto ritobin_cli.exe.

A working .bin file appears next to it, ready to load.

Tip: quick convert with default program

Set ritobin_cli.exe as the default program for .py files. Then a double-click converts the file. No more drag-and-drop.

Step	Action
1	Right-click the `.py` file
2	Select Open with then Choose another app
3	Pick `ritobin_cli.exe`
4	Check Always use this app

Other formats

Ritobin also reads and writes json and info, not only text (.py). Useful if you want to script edits in another language.

Open a terminal in the Ritobin folder and run:

ritobin_cli.exe -o json input.bin output.json
ritobin_cli.exe -o text input.json output.py

The -o flag sets the output format. The -i flag sets the input format if Ritobin can't guess from the extension.

Ritobin

What you need before you start

Install

Convert files

Convert `.bin` to `.py`

Open the `.py` file

Convert `.py` back to `.bin`

Tip: quick convert with default program

Other formats

Troubleshooting

Conversion does nothing or output is empty

Output file has hashed names instead of words

"This app can't run on your PC" error

Source

On this page