LinuxAlternative

Linux · Sound & Video

Haruna

Haruna is a GPL‑licensed, open‑source media player that supports local and online playback with extensive customization.

Open sourceFreeFlatpak
Be the first to rate
License
GPL-3.0-or-later
Latest version
1.8.1 (May 19, 2026)
Developer
George Florea Bănuș
Installs
10,177 (Flathub, 30 days)

What is Haruna?

Haruna is a relatively new player that has grown steadily since its first release in 2015. It is built on modern libraries and ships with a clean, minimal interface that can be heavily tweaked through keyboard shortcuts and mouse actions. The project is actively maintained, with the latest version 1.8.1 released in May 2026.

The player targets users who need a lightweight yet feature‑rich alternative to VLC. It works well on Debian‑based, Arch, Fedora, openSUSE, and Ubuntu systems, and can be installed directly from Flathub or the respective package manager.

Compared to VLC, Haruna feels more streamlined and less cluttered. It offers a focused set of features, especially for online video and playlist handling, while keeping the UI simple and responsive.

Best for: Users who want a lightweight, customizable media player that excels at online video and playlist management.

Key features of Haruna

  • Plays local and online videos, including YouTube via youtube‑dl
  • Supports YouTube playlists and auto‑skips chapters containing specific words
  • Mouse‑over playlist toggle and overlay on video
  • Configurable shortcuts and mouse buttons
  • Quick jump to next chapter with middle‑click on progress bar
  • Open source, GPL‑3.0‑or‑later license
  • Available as Flatpak, Arch, Debian, Fedora, openSUSE, Ubuntu

Pros

  • Highly customizable keyboard and mouse controls
  • Supports online video and playlist features out of the box
  • Lightweight and fast compared to larger players
  • Open source with active community

Cons

  • Limited advanced playback options compared to VLC
  • No built‑in subtitle downloaders beyond youtube‑dl
  • Interface may feel too minimal for users used to complex UIs

Windows programs Haruna replaces

How to install Haruna on Linux

Flatpak (Flathub)flatpak install flathub org.kde.haruna
Ubuntu / Mintsudo apt install haruna
Debiansudo apt install haruna
Fedorasudo dnf install haruna
Arch / Manjarosudo pacman -S haruna
openSUSEsudo zypper install haruna

Tips for Windows users

If you come from VLC, most common file formats (MP4, MKV, AVI, MP3, etc.) will play without issue. Haruna uses the same keyboard shortcuts as VLC for basic actions (space to pause, arrow keys to seek). The main workflow difference is the mouse‑over playlist toggle: hover over the video to reveal the playlist. For online playback, simply paste a YouTube URL into the address bar; Haruna will automatically fetch the video via youtube‑dl. Remember to install the youtube‑dl package if you need to play other online sources.

Recent releases

  • 1.8.1 —

    Features - open multiple files from command line, allows to open only the selected files in the file manager - stop action, available in the playback - setting to enable taskbar progress - show filename/title in OSD when opening a file - mpris: find and set…

  • 1.7.1 —

    Bugfixes - fixed searching playlist - fixed tooltip background being same color as its text

  • 1.7.0 —

    Features PlayList - added advanced sorting and grouping - added context menu to open file in Hana (thumbnail generator, only if it's installed) - the last active playlist will be set as visible when starting the app Other - added replay gain settings - mpris…

  • 1.6.0 —

    Features - Added option to resize playlist - Moved the action to add a new playlist/tab to the tabbar - Moved the action to open a playlist in the "Add" menu - Added an icon for playback action in playlist header - Mouse settings: action assigned to a mouse…

Haruna: frequently asked questions

Can Haruna play online videos?

Yes, it can play YouTube videos and playlists using youtube‑dl, and supports other online sources if youtube‑dl is installed.

Is Haruna free?

Haruna is free and open source, released under the GPL‑3.0‑or‑later license.

Does Haruna support subtitles?

It supports subtitles that are present in the media file or provided via external files; it does not automatically download subtitles.

How do I customize shortcuts?

Shortcuts can be configured in the settings menu; you can assign any key or mouse button to actions such as play, pause, skip, and more.

Updated