Install Hosaka Studio

One command installs Hosaka Studio on Debian, Ubuntu, Fedora, Arch, and derivatives.

Install with one command

Automatically detects your distribution and sets up the native package repository.

curl -fsSL https://hosaka.studio/install.sh | bash

What does this command do?

The install script detects your distribution and performs the appropriate steps:

On Debian/Ubuntu:

Downloads our GPG signing key to /usr/share/keyrings/
Adds the Hosaka Studio apt repository
Runs apt update and installs hosaka-studio

On Fedora:

Imports the GPG signing key via rpm --import
Adds the Hosaka Studio dnf repository
Installs the hosaka-studio package via dnf

On Arch Linux:

Imports the GPG signing key via pacman-key
Appends the [hosaka] repository block to /etc/pacman.conf
Runs pacman -Sy hosaka-studio

Preview with: curl -fsSL https://hosaka.studio/install.sh | bash -s -- --dry-run

Not on a supported distro? Install via Flatpak instead

Prefer to run each step manually?

These are the same commands the install script runs. Use this as a reference or if you want more control.

Select your distribution:

01 Add the GPG key

curl -fsSL https://apt.hosaka.studio/gpg-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/hosaka-studio.gpg

02 Add the repository

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/hosaka-studio.gpg] https://apt.hosaka.studio stable-bookworm main" | sudo tee /etc/apt/sources.list.d/hosaka-studio.list

03 Update and install

sudo apt update && sudo apt install hosaka-studio

01 Import the GPG key

curl -fsSL https://arch.hosaka.studio/GPG-KEY-hosaka | sudo pacman-key --add - && sudo pacman-key --lsign-key hosaka

02 Add the repository

Append the following block to /etc/pacman.conf:

[hosaka]
Server = https://arch.hosaka.studio/x86_64
SigLevel = Required DatabaseOptional

03 Sync and install

sudo pacman -Sy hosaka-studio

01 Import the GPG key

sudo rpm --import https://rpm.hosaka.studio/GPG-KEY-hosaka

02 Add the repository

sudo dnf config-manager addrepo --from-repofile=https://rpm.hosaka.studio/hosaka-studio.repo

03 Install

sudo dnf install hosaka-studio

Troubleshooting

If recording, playback or export misbehaves, run the built-in diagnostics. They check your GPU, drivers, FFmpeg and OpenGL without opening a window, and save a copy of the report next to the Hosaka log:

hosaka --doctor

On Flatpak, use flatpak run com.hosaka.studio --doctor. Attach the saved report (its path is printed at the end) when you email [email protected] about a problem.

Uninstall

To completely remove Hosaka Studio and the apt repository:

sudo apt remove hosaka-studio && sudo rm /usr/share/keyrings/hosaka-studio.gpg /etc/apt/sources.list.d/hosaka-studio.list

Fallback option

Flatpak

Works on any Linux distribution with Flatpak support. Use this if your distro isn't listed above.

Note: The Flatpak build has limited support on wlroots-based compositors (Sway, Hyprland, etc.). If you're on a supported distro, the install script is recommended.

Manual installation (terminal)

flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --user --if-not-exists hosaka-studio https://flatpak.hosaka.studio/hosaka-studio.flatpakrepo
flatpak install --user hosaka-studio com.hosaka.studio

This adds the Flathub runtime repository, the Hosaka Studio repository, and installs the app.

Running

Launch Hosaka Studio from your application menu, or run from terminal:

flatpak run com.hosaka.studio

Update

If you installed from the repository, updates are automatic when you run:

flatpak update --user com.hosaka.studio

Uninstall

To remove Hosaka Studio:

flatpak uninstall --user com.hosaka.studio