Repository navigation
Releases: gridoe/refryt
Release list
refryt 0.1.14
Linux — refryt-0.1.14-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak — refryt-0.1.14-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.14-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 51 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a browser" is hidden
and you sign in through the app's own window; "Launch on startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — three options for x64, and two for ARM, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.14-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.14-windows-x86_64.msi— the same files as an MSI, for deployment tools or a
silent install (msiexec /i refryt-0.1.14-windows-x86_64.msi /qn). It installs to the same
folder as the setup, so use one or the other.refryt-0.1.14-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.refryt-0.1.14-windows-arm64.msi/.zip— a native build for Windows on ARM, not yet tested
on ARM hardware. The x64 files also run there under emulation.
macOS — refryt-0.1.14-macos-arm64.dmg, for Apple Silicon only. Open it and drag
Refryt to Applications. It is signed ad hoc and not notarized, so
macOS will refuse to open it on the first launch. Run xattr -cr /Applications/Refryt.app once,
or allow it in System Settings → Privacy & Security. libmpv and yt-dlp are bundled; nothing needs
installing.
Checksums for every file are in refryt-0.1.14-SHA256SUMS.txt.
What changed since 0.1.13:
- Import from browser, in one click — Home and Settings have one "Import from browser"
button. It picks the browser you used most recently and lists only browsers that have a
sign-in to import; with more than one, a menu lets you choose. New: Firefox forks (Zen,
LibreWolf, Floorp, Waterfox), Opera, Whale, Helium, and Flatpak and Snap installs on Linux. On
Windows any Chromium browser without app-bound encryption works, and a browser that holds its
cookie file locked says to close it and try again. (#9) - Volume keys — Ctrl+↑ and Ctrl+↓ change the volume on Linux and Windows, as ⌘+↑/↓ already
did on macOS. (#10) - Linux tray in the Flatpak — the tray icon now works there, and it brings the window back
in front. The Flatpak moves to the GNOME 51 runtime with mpv 0.41. - Windows — the tray icon is sharp instead of a shrunken large icon (#11), and launching
refryt a second time no longer leaves the X button unable to hide the window (#12). - Layout fixes — track rows keep their number and cover inside the hover highlight, song
rows on Home have no wide gap when a song has no length, and Ctrl with +, - or 0 no longer
zooms the layout out of its cards.
refryt 0.1.13
Linux — refryt-0.1.13-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak — refryt-0.1.13-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.13-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 49 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a browser" is hidden
and you sign in through the app's own window; "Launch on startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — three options for x64, and two for ARM, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.13-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.13-windows-x86_64.msi— the same files as an MSI, for deployment tools or a
silent install (msiexec /i refryt-0.1.13-windows-x86_64.msi /qn). It installs to the same
folder as the setup, so use one or the other.refryt-0.1.13-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.refryt-0.1.13-windows-arm64.msi/.zip— a native build for Windows on ARM, not yet tested
on ARM hardware. The x64 files also run there under emulation.
macOS — refryt-0.1.13-macos-arm64.dmg, for Apple Silicon only. Open it and drag
Refryt to Applications. It is signed ad hoc and not notarized, so
macOS will refuse to open it on the first launch. Run xattr -cr /Applications/Refryt.app once,
or allow it in System Settings → Privacy & Security. libmpv and yt-dlp are bundled; nothing needs
installing.
Checksums for every file are in refryt-0.1.13-SHA256SUMS.txt.
What changed since 0.1.12:
- Updates from inside the app — refryt looks for a new release on GitHub when it starts
("Check for updates" in Settings → About turns it off). The Windows setup and MSI installs and
the AppImage update and restart in place; the Flatpak, the AUR package and macOS say a new
version is out and link its release page. "Later" keeps the notice away for a day. Thanks to
@TZANTOU. (#5, #7) - Keep the songs you jump over — a new option in Settings → Playback → Queue and history. With
it on, playing a song further down Up next plays it now and keeps the songs that were before it
as the next ones, in their order. Off by default, which skips them as before. - Linux tray — a left click on the tray icon shows and hides the window, and hovering shows
its name. On KDE Plasma's Wayland session, hiding to the tray now takes the window off the
taskbar, and the tray icon brings it back in front. The Flatpak can't do that part: there the
window still minimises to the taskbar. - macOS — the window's traffic lights sit over the sidebar, as in other Mac apps (thanks to
@hanandewa5, #8), and there is a menu bar with Playback, View, Window and Help menus. A window
minimised from the app's own button no longer freezes once it is restored, and the app keeps
its own icon in the Dock while it runs. - Fewer sign-in refreshes — an empty section in the Library or History was taken for an
expired sign-in, so an account with one renewed its sign-in on every launch. (#4)
refryt 0.1.12
Linux — refryt-0.1.12-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak — refryt-0.1.12-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.12-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 49 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a browser" is hidden
and you sign in through the app's own window; "Launch on startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — three options for x64, and two for ARM, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.12-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.12-windows-x86_64.msi— the same files as an MSI, for deployment tools or a
silent install (msiexec /i refryt-0.1.12-windows-x86_64.msi /qn). It installs to the same
folder as the setup, so use one or the other.refryt-0.1.12-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.refryt-0.1.12-windows-arm64.msi/.zip— a native build for Windows on ARM, not yet tested
on ARM hardware. The x64 files also run there under emulation.
macOS — refryt-0.1.12-macos-arm64.dmg, for Apple Silicon only, added to this page after the
other files. Open it and drag Refryt to Applications. It is signed ad hoc and not notarized, so
macOS will refuse to open it on the first launch. Run xattr -cr /Applications/Refryt.app once,
or allow it in System Settings → Privacy & Security. libmpv and yt-dlp are bundled; nothing needs
installing.
Checksums for every file are in refryt-0.1.12-SHA256SUMS.txt.
What changed since 0.1.11:
- No sign-in window at launch — when YouTube stops accepting a saved sign-in, the app now
renews it with a hidden window instead of opening the Google login page, and says "Your sign-in
expired" when it can't. On macOS 14 and later the window keeps Google's session between runs,
so a stale sign-in renews quietly. (#4) - Sign in by pasting cookies — a third option on Settings' Account tab, for when neither the
sign-in window nor the browser import can be used (macOS before 14, Linux without WebKitGTK).
It walks through copying the cookie request header from a browser's developer tools. - Profile pages load in their own shape — a person's channel, yours or a playlist owner's,
shows a round picture, name and Subscribe placeholder instead of the artist page's.
refryt 0.1.11
Linux — refryt-0.1.11-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak — refryt-0.1.11-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.11-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 49 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a browser" is hidden
and you sign in through the app's own window; "Launch on startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — three options for x64, and two for ARM, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.11-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.11-windows-x86_64.msi— the same files as an MSI, for deployment tools or a
silent install (msiexec /i refryt-0.1.11-windows-x86_64.msi /qn). It installs to the same
folder as the setup, so use one or the other.refryt-0.1.11-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.refryt-0.1.11-windows-arm64.msi/.zip— a native build for Windows on ARM, not yet tested
on ARM hardware. The x64 files also run there under emulation.
macOS — refryt-0.1.11-macos-arm64.dmg, for Apple Silicon only, added to this page after the
other files. Open it and drag Refryt to Applications. It is signed ad hoc and not notarized, so
macOS will refuse to open it on the first launch. Run xattr -cr /Applications/Refryt.app once,
or allow it in System Settings → Privacy & Security. libmpv and yt-dlp are bundled; nothing needs
installing.
Checksums for every file are in refryt-0.1.11-SHA256SUMS.txt.
What changed since 0.1.10:
- Recent searches — click into the empty search box to see your last 15 searches. Click one
to run it again, ✕ to remove one, or Clear to remove them all. They're kept on your computer
only. - "No results" instead of an error — a search with nothing to show says so, with YouTube's
"Did you mean" suggestion when it has one. Some searches used to fail with a parser error. - Fixed playback failing on some songs.
- No overlap when a song fails — if the next song can't load, the previous one stops instead
of playing on. - Sign in opens straight away — the Sign in buttons on Home, Library and History open the
sign-in window directly instead of going to Settings first. - The sign-in window follows the app's theme — it's dark in the Flatpak too. If the window
crashes, Settings says so instead of showing an unrelated warning. - Windows renders through DX12 — it starts faster and uses less CPU and memory while
scrolling. Windows also gets the Transparency slider and Background Blur, plus rounded corners
and a shadow. - Fixed a Windows crash when an artist banner scrolled out of view, the crash 0.1.10 had on
Windows. - MSI upgrades keep their files — upgrading over an MSI install no longer removes libmpv,
WebView2Loader and yt-dlp. refryt.exe now shows its version in Properties.
refryt 0.1.10
Linux — refryt-0.1.10-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak — refryt-0.1.10-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.10-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 49 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a browser" is hidden
and you sign in through the app's own window; "Launch on startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — three options for x64, and two for ARM, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.10-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.10-windows-x86_64.msi— new: the same files as an MSI, for deployment tools or a
silent install (msiexec /i refryt-0.1.10-windows-x86_64.msi /qn). It installs to the same
folder as the setup, so use one or the other.refryt-0.1.10-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.refryt-0.1.10-windows-arm64.msi/.zip— a native build for Windows on ARM, added after
the release and not yet tested on ARM hardware. The x64 files also run there under emulation.
macOS — refryt-0.1.10-macos-arm64.dmg, for Apple Silicon only, added to this page after the
other files. Open it and drag Refryt to Applications. It is signed ad hoc and not notarized, so
macOS will refuse to open it on the first launch. Run xattr -cr /Applications/Refryt.app once,
or allow it in System Settings → Privacy & Security. libmpv and yt-dlp are bundled; nothing needs
installing.
Checksums for every file are in refryt-0.1.10-SHA256SUMS.txt.
What changed since 0.1.9:
- Readable text in every theme — secondary and dimmed text, and accent-coloured text such as
the playing row and the current lyric line, are now lifted to a readable contrast on every
theme's cards and background. - A Spotify theme — dark, in Spotify's colours. It shows up in an existing themes folder too.
- Buttons say what they do — the player bar, fullscreen and top bar icons show a label on
hover, with the shortcut where there is one. - Errors say why — a failed action's toast gives the reason when there is one, and stays up a
little longer. - Track counts move at once — adding a song to a playlist, or removing one, changes its count
straight away instead of after the next refresh. - Snaps to half a portrait screen — the window can now be as narrow as the icon rail beside
the page. In a narrow window the queue/lyrics panel steps aside and the player bar goes compact. - Fullscreen — no shadow under the cover, and longer, eased fades at the top and bottom of the
lyrics. - Up next — the playing row has a right-click menu like the others.
- Smaller things — hover play buttons light up and grow slightly; the window buttons are
dimmed while the window is not focused; Search and History name an item's type in its subtitle
rather than in the duration column; Settings labels are in sentence case.
refryt 0.1.9
Linux — refryt-0.1.9-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak — refryt-0.1.9-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.9-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 49 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a Browser" is hidden
and you sign in through the app's own window; "Launch on Startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — two options, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.9-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.9-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.
macOS — refryt-0.1.9-macos-arm64.dmg, for Apple Silicon only, added to this page after the
other files. Open it and drag Refryt to Applications. It is signed ad hoc and not notarized, so
macOS will refuse to open it on the first launch. Run xattr -cr /Applications/Refryt.app once,
or allow it in System Settings → Privacy & Security. libmpv and yt-dlp are bundled; nothing needs
installing.
What changed since 0.1.8:
-
Minimized, the next song plays — on Windows, macOS and X11 a minimized window played its
song out and then stopped, and the media keys did nothing until the window was shown again.
It now goes on to the next song and answers the media keys while minimized or hidden to the
tray. Wayland was not affected. -
Shuffle keeps one order — turning shuffle on draws an order for the rest of the queue,
your own songs before the radio's, and keeps it: Up next shows the songs in the order they
will play, the next one is loaded ahead of time as it is without shuffle, and Previous steps
back through the order they played in. Turning shuffle off goes on in list order from the
song playing. With Repeat All each round gets a new order, never starting with the song that
just ended. -
The volume is kept on a fresh install — a volume set before anything was ever queued was
forgotten on the next launch. -
Changes made while the app is idle are saved at once — a shuffle or volume change from the
desktop's media controls could wait until the window next drew, and was lost if the app was
closed by force before then. -
macOS: fullscreen stays see-through — fullscreen used to show black behind a translucent
window. It now covers the screen on the current desktop and hides the Dock and menu bar, so the
blurred desktop shows through. This fix is in the macOS download only; it landed indc5e1b0,
just after the 0.1.9 tag.
refryt 0.1.8
Linux — refryt-0.1.8-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak — refryt-0.1.8-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.8-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 49 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a Browser" is hidden
and you sign in through the app's own window; "Launch on Startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — two options, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.8-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.8-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.
macOS — refryt-0.1.8-macos-arm64.dmg, for Apple Silicon only, added to this page after the
other files. Open it and drag Refryt to Applications. It is signed ad hoc and not notarized, so
macOS will refuse to open it on the first launch. Run xattr -cr /Applications/Refryt.app once,
or allow it in System Settings → Privacy & Security. libmpv and yt-dlp are bundled; nothing needs
installing.
What changed since 0.1.7:
- Icon rail — drag the sidebar narrow and it folds down to a rail of icons and playlist
covers, with each name in a tooltip beside the pointer. The sidebar now keeps the width it was
dragged to across launches, and no longer snaps back to its old width when made narrower. - Scroll Fades — Settings → Appearance → Window. Off by default and recommended with
transparency. Lists in the cards and on every page fade out at an edge with more to scroll to,
and the fade is real transparency, so the desktop shows through on a see-through window. In the
fullscreen player the queue and plain lyrics fade the same way, rather than into a band of solid
colour. - Playback fixes
- Next pausing instead of replaying, with Repeat One on the last song or a one-song queue on
Repeat All. - Autoplay stopping at the end of a queue brought back from the last session.
- Shuffle with Repeat All leaving one song out of every round after the first.
- Add to Queue during a radio song marking the wrong song as playing, so Next replayed it.
- A song picked after launch sometimes starting where the last session's song had stopped.
- The media keys' Previous doing nothing on the first song of a queue.
- Next pausing instead of replaying, with Repeat One on the last song or a one-song queue on
- Volume and mute are kept — muting from the speaker icon used to lose the volume, so the app
came back at the default level, and unmuting from the icon stayed silent. The volume and the
mute now both survive a relaunch. - A minimized window no longer stops the app on Wayland — the queue, media keys and tray kept
waiting until the window was restored. - Fewer wakeups while playing — PipeWire is asked for 45 ms steps, so a playing song wakes
the app about half as often. - Smaller fixes — a page loading in a window that isn't maximized keeps its card's bottom
corners round; the lyrics card fills its width while it loads and has no blank space below the
last line; the queue and lyrics panel keeps the width it was dragged to when made narrower.
refryt 0.1.7
Linux — refryt-0.1.7-x86_64.AppImage: download, chmod +x, run. Or use
scripts/appimage-install.sh install from source for a desktop launcher entry.
Linux, Flatpak (new) — refryt-0.1.7-x86_64.flatpak. It isn't on Flathub, so install the file:
flatpak install --user refryt-0.1.7-x86_64.flatpak, then flatpak run io.github.gridoe.refryt.
It needs the GNOME 49 runtime, which Flatpak offers to fetch the first time. mpv and yt-dlp are
inside. The sandbox can't see your browsers' profile folders, so "Import from a Browser" is hidden
and you sign in through the app's own window; "Launch on Startup" is hidden too, since a sandboxed
app can't write a login item.
Windows — two options, cross-compiled from Linux with limited testing on real Windows
hardware:
refryt-0.1.7-windows-x86_64-setup.exe— a real installer (Program Files, Start Menu,
uninstaller). Unsigned, so SmartScreen will warn on first run — expected, not a bug.refryt-0.1.7-windows-x86_64.zip— portable, no install: unzip and runrefryt.exe.
Extract the whole folder before running; the exe needs the DLLs beside it.
macOS — refryt-0.1.7-macos-arm64.dmg, for Apple Silicon only. Open it and drag Refryt to
Applications. It is signed ad hoc and not notarized, so macOS will refuse to open it on the first
launch. Run xattr -cr /Applications/Refryt.app once, or allow it in System Settings → Privacy &
Security. libmpv and yt-dlp are bundled; nothing needs installing.
What changed since 0.1.6:
- Flatpak — a
.flatpakbundle on the releases page, built frompackaging/flatpak/
(just flatpakmakes one from source). - See-through that stays see-through — chips, the search box, Settings cards, the Explore
tiles, the selected entry in the sidebar, hover fills, switches and slider tracks no longer sit
on a see-through window as solid dark slabs, and the faint text (track counts, times) gets
brighter as the window gets more transparent so it stays readable. Fullscreen's background now
follows the window's transparency too. - Card Outlines — Settings → Appearance → Window has a switch for a thin edge around each
card. It's on by default, on a solid window as well as a see-through one. - Strict Home Order — Settings → Library → Home. Off by default. With it on, Home follows
YouTube's feed until your top seven sections have appeared, or six seconds have passed, and then
sorts. Whatever is left keeps loading as you scroll. It only matters when YouTube sends a section
late. - Fullscreen — opening the queue no longer makes the lyrics jump: they're wrapped to the width
they settle at, the drawer slides in without passing over them, and the cover, lyrics and drawer
are centred on the screen as one group. - The window can't get too narrow — the least width is 760, or 872 while the queue or lyrics
panel is open. The side panels give way first so the page keeps room for itself, and the window
grows if you open a panel in one that's too narrow. - Lighter while it runs — about 6 MB less memory with Home loaded, a song costs about 60%
fewer wakeups (the progress bar and clock now tick once a second), and the app no longer wakes
every second to look at the themes folder. A theme you edit shows up when you come back to the
window or open Settings, not within a second of saving. - A window left fullscreen no longer comes back stuck — closing the app with the fullscreen
player open used to restore the window fullscreen next time, with minimize and maximize doing
nothing and rounded corners on it. It now leaves fullscreen at launch and opens at its normal
size. - Card outlines are whole on a solid window — with transparency off, the repair of each
card's rounded corners painted over the corner pixels of the outline and left the arcs broken.
They are now drawn once, a single crisp pixel, after that repair. - Flatpak downloads — the sandbox had read-only access to Music, so a Premium account's
downloads would have failed there. It can write to~/Music/refrytnow. - Release tooling —
scripts/release.shbumps the version, checks every artifact agrees, and
publishes;just installnow installs only the app.