Haruna

Haruna 1.8

Tue, 19 May 2026 23:00:00 +0200

Haruna version 1.8.1 is released.

If you like Haruna then support its development

Windows version:

Availability of other package formats depends on your distro and the people who package Haruna.

Feature requests and bugs should be posted on bugs.kde.org, ignoring the bug report template can result in your report being ignored.

Known issues

The animation for the playlist can be stuttery/slow when playback is active. You can improve it by creating two custom commands that run on startup:

set override-display-fps 75 (replace 75 with your monitor's refresh rate)
set video-sync display-resample

These don't work for variable refresh rate monitors.

Changelog

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 menu
setting to enable taskbar progress
show filename/title in OSD when opening a file
mpris: find and set cover from external image file for audio files without internal covers
custom loading animation
setting for mpv's sub-border-style property

Playlist

menu item to open file in MediaInfo app (if installed)
allow sorting ascending/descending for None option
indicator for resume playback position under the duration
item drag handle is now shown on hover

Bugfixes

hide chapters menu button when there are no chapters
font family reset button not saving the setting

Playlist

restore last active playlist only if opening without a file
slow scroll to playing item on startup
clicks triggering playlist item under the tab
no context menu on tabs

Haruna 1.7

Wed, 14 Jan 2026 12:00:00 +0200

Haruna version 1.7.1 is released.

playlist advanced sorting and grouping

Windows version:

Availability of other package formats depends on your distro and the people who package Haruna.

If you like Haruna then support its development: GitHub Sponsors | Liberapay | PayPal

Feature requests and bugs should be posted on bugs.kde.org, ignoring the bug report template can result in your report being ignored.

Known issues

The animation for the playlist can be stuttery/slow when playback is active. You can improve it by creating two custom commands that run on startup set override-display-fps 75 (replace 75 with your monitor's refresh rate) and set video-sync display-resample.

These don't work for variable refresh rate monitors.

Changelog

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 (Muhammet Sadık Uğursoy)
added context menu to open file in Hana (thumbnail generator, only if it's installed). Get it from flathub
the last active playlist will be set as visible when starting the app

Other

added replay gain settings (Muhammet Sadık Uğursoy)
mpris thumbnail is only set for audio files, this allows the os taskbar preview to show the actual live window
decreased the size of the play icon in the compact playlist

Bugfixes

fixed database folder not being created
fixed seekbar tooltip not updating when file changes and the mouse is not moved
fixed deleting custom commands
fixed saving last opened url

Haruna 1.6

Fri, 24 Oct 2025 23:23:00 +0200

Haruna version 1.6.0 is released.

Windows version:

Availability of other package formats depends on your distro and the people who package Haruna.

If you like Haruna then support its development: GitHub Sponsors | Liberapay | PayPal

Feature requests and bugs should be posted on bugs.kde.org, ignoring the bug report template can result in your report being ignored.

Changelog

1.6.0 Known issues

On Windows the Shortcuts and Custom Commands settings pages don't work.

Features

added option to resize playlist
added an icon for playback action in playlist header
moved the action to add a new playlist/tab to the tabbar
moved the action to open a playlist in the "Add" action
mouse settings: action asssigned to a mouse event can be changed

Bugfixes

fixed looping playlist with a single files
fixed playlist tabs not being saved
fixed renaming playlists right after adding them
fixed next/previous buttons being disabled while adding items via dropping in "Add to Playlist" split area
fixed play previous action not wrapping from first item in playlist to the last item
fixed not being able to add new playlist tab when yt-dlp is not installed
added a workaround for file dialogs not receiving key events; escape and arrow key were not working

Haruna 1.5

Tue, 30 Sep 2025 21:00:00 +0200

Haruna version 1.5.0 is released.

The highlight of this release is the playlist, which got a lot of features:

multiple playlists through tabs (Muhammet Sadık Uğursoy)
drag and drop reordering (Muhammet Sadık Uğursoy)
add files and folders through drag and drop (Muhammet Sadık Uğursoy)
filtering (Muhammet Sadık Uğursoy)
option to control playback behavior when a file ends: repeat playlist, repeat file, stop after last file in playlist, stop after current fille and play a random item

Another big change is to the Mouse settings, now you can use a mouse button + modifier key combo (ctrl + left click, shift + scroll up/down etc.).

Windows version:

Availability of other package formats depends on your distro and the people who package Haruna.

If you like Haruna then support its development: GitHub Sponsors | Liberapay | PayPal

Feature requests and bugs should be posted on bugs.kde.org, ignoring the bug report template can result in your report being ignored.

Changelog

1.5.0 Known issues

On Windows the Shortcuts and Custom Commands settings pages don't work.

Features

Settings

General
- added single instance setting to play new file when appending to the playlist
- removed the "File dialog location setting"
Playlist: added settings to control playback behavior
Mouse
- changed to allow modifier keys
- added support for Mouse Forward and Back buttons
Subtitles: if a relative folder name in the Load subtitle from list starts with an * (asterisk) then subtitles will be searched in all folders contaning the folder name. Example: If the Load subtitle from list contains an entry *sub and you have the following folders next to the video file subs, more subs and subtitles all of these folders will be searched.
the settings window now has a minimum width and height

PlayList

added support for multiple playlists
items can be reordered manually through drag and dropdown
items can be selected, ctrl+click to select multiple items, shift+click to select a range
items can be filtered
added setings to control playback behavior when a file ends
when saving the playlist the file extension is set to m3u
can add files and folders through drag and drop
multiple files can be added through the option in the header
hide playlist when mouse leaves window while maximized, prevents opening the playlist when moving mouse to another monitor

Playback

if a file can't be played now an error is shown and playback stops instead of trying to play the next file (prevents a potential infinite loop when no file in the playlist can be played)
can play files starting with a dot (hidden files)
an error is shown when failing to get youtube playlist

Other

mpris: add support for Shuffle and LoopStatus
changed the action selection popup to use Kirigami.SearchDialog
replaced the spinning icon with a progress bar and label
the drop area of the video is split in 2 parts now
- top part always appends to the default playlist
- bottom part clears the default playlist and adds the dropped files and folders, when only one file is dropped it behaves as the open file action (clears the playlist and loads sibling files if enabled in settings)
recent files are now stored in a sqlite database
time positions used to restore videos are also stored in the database
sleep is blocked on Windows too
all strings should be translatable now

Bugfixes

fixed the loop action, osd was not showing and progress bar was not highlighting the loop range
before loading check that the file exists
fixed loading wrong subtitles when using recursive subs
fixed the progress bar getting taller when the chapters menu becomes visible
fixed a bug where the video would pause after clicking the progress/seek bar