Getting started
Installing
On Windows, the download is the program itself, with no installer. It needs the WebView2 runtime, which Windows 10 and 11 already have.
On Linux, there’s a package for the big families of distributions, about 5 MB each, which use the web engine your system already has:
| Download | For | To install it |
|---|---|---|
.deb | Ubuntu, Debian, Mint, Pop!_OS | double-click it, or sudo apt install ./Sublime-Itch_amd64.deb |
.rpm | Fedora | double-click it, or sudo dnf install ./Sublime-Itch.x86_64.rpm |
.pkg.tar.zst | Arch and the distributions based on it | sudo pacman -U Sublime-Itch-x86_64.pkg.tar.zst |
Any of them puts Sublime Itch in the applications menu, and installing a newer one the same way updates it. The demo’s packages work the same, and installing the full version over the demo replaces it, keeping your library as it is.
On any other Linux, or if you’d rather not install anything, there’s the AppImage, about 80 MB because it carries its own web engine. Make it executable (in a file manager, under the file’s properties, or with chmod +x in a terminal) and run it. The first time, it offers to add itself to the applications menu. A copy installed by the itch app stays where it is, so the itch app will keep it up to date.
Your first devlog
The left most panel of the app is the library. A new project starts from the folder button at its top (or Ctrl+N when nothing is open): give it the game or tool’s name, and choose whether it starts with a devlog or with the game’s page. A game page is the local file equivalent to the game or tool front page on itch. Only one game page file can exist per project.
The preview on the right follows as you type. The toolbar above the editor has buttons for common formatting options, and Writing a devlog lists everything the editor understands.
Signing in to itch
Sign in to itch.io, the button at the top right, opens itch’s own login page in a window of its own. Signing in is needed to upload and fetch images, devlogs and gampages to and from itch.
Posting it Manually
When the devlog is ready, press the red copy button at the right end of the preview’s bar. A number beside it means it has images itch doesn’t have yet: it will uploads those first. Then, on itch:
- Open the devlog post (a new one, or the draft you’re updating).
- Switch its editor to the HTML view, with the
<>button. - Replace what’s there with what you copied.
- Important: Type a character in the normal view and delete it again, then save.
Don’t skip that last step: without it, itch can drop what you pasted, and the post goes back to what it was when you save and reload.
Where your devlogs are kept
Every devlog is a Markdown file, in a folder per project:
- Windows:
%APPDATA%\cl.gcat.sublime-itch\library - Linux:
~/.local/share/cl.gcat.sublime-itch/library
They’re ordinary files you can back up, sync or open in another editor. Right-click a devlog and choose Show in file manager to jump to it.