Skip to content

Releases

Basalt v1.6.4

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 15 Nov 07:15

Basalt v1.6.4

Your devices now pass files and whole folders to each other: straight across when both are on, through the host when one is away, and to devices nearby that aren't on your host at all, even with no Wi-Fi in common. Music playing on several devices at once holds together far better, Basalt stays ready to receive in the background, and Linux gets the tray, notifications and "Share with Basalt" that Windows has.

Sharing between your devices

  • Share from anywhere. Choose Share on any file or folder, on the drive or on the device itself, and pick where it goes. Your devices that are on show with a green dot under Your devices.
  • Folders arrive as folders. A shared folder lands in the received folder with everything in it in its own folders, at home, nearby and through the host. Sent twice, it arrives as "Holiday (1)" beside the first, never mixed in. Hidden and system files stay behind, and up to 1,000 files go in one share.
  • Who sent it is told by your host, so a device can't claim to be someone else in your home.
  • Your own devices take it at once. Sent to another device of your own profile, a file just arrives, with no question. Another profile in your home is asked first, or takes it by itself if they chose to accept files from home.
  • Straight across, or through the host. Files go directly from one device to the other. If the other device is off, the host keeps them and delivers them when it is back. If a computer's firewall stops the direct way, they go through the host instead, by themselves.
  • Kept apart and locked on the host. Files waiting on the host are kept outside your shared drive and encrypted, readable only by the sender, the receiver and someone at the host computer. Manage host and the host window show how much they take, can limit what each profile keeps, and can clear them all; senders are told if theirs were removed.
  • What you left on the host. Shared through host in Settings (on a phone, More) lists the files you sent through the host, to send again to another device or to remove. Remove from the host once answered is on by default: a file goes from the host as soon as it's accepted or declined, and you can change that for one send.
  • Removing a profile asks what to do with the files it kept on the host: move them onto the drive, into "Basalt shares", or delete them.
  • Accept on any of your devices. A file offered to you can be accepted on whichever of your devices is in front of you, and it goes to that one. An offer nobody answers ends after 10 minutes.
  • Progress on both ends. The sender sees the file accepted, moving and arrived; the receiver sees it come in. A transfer carries on if either side drops for a moment, and Stop ends a file you're sending from your device.
  • It says when it goes another way. If the two devices can't reach each other directly, both say so, and the file goes through the host instead.
  • Inbox. Received and Sent, with Open, Show in folder and Share for what arrived. Choose where received files go in Settings.
  • From your other apps. On Windows, Share with Basalt is in File Explorer's menu for files and folders (under Show more options on Windows 11), and in Send to. On Android, Basalt is in the system's Share menu. On Linux, see below.
  • Programs never open by themselves. A program that arrives is shown in its folder, for you to decide.

Your devices

  • See and remove them. Each profile's devices are listed, with which are online: on a phone in More, Your devices; on a computer in the profile menu; in Manage host, Profiles; and in the host's window, under each profile.
  • Lost, sold or lent? Remove signs your profile out of that device at once. It stays in your home for anyone else, and asks for your PIN to be yours again.

Devices nearby

  • Send to someone not in your home. Share with a device nearby reaches devices around you that aren't on your host, before any drive is set up. Each shows by name and a short code, so you can tell two phones of the same model apart.
  • No shared Wi-Fi needed. On the same Wi-Fi it goes over that. With no Wi-Fi in common, devices find each other by Bluetooth: the one receiving opens a small Wi-Fi of its own only for that transfer, the sender joins it, and both go back to their own Wi-Fi after. Being ready costs your Wi-Fi nothing.
  • It says what it needs. Bluetooth off, or Android's "Nearby devices" permission not given: the Nearby page says so, with the button that puts it right.
  • You accept each one. Turn on Receive from devices nearby to be found; nothing arrives without your yes, and never more than you accepted. Always ask for a code adds a six-digit code the sender types, for busy places. Two devices showing the same name and letters always need the code.
  • Encrypted, and guarded. Every share between devices nearby is encrypted, and a device can't send more than you accepted or flood you with offers.
  • The firewall. If Windows Firewall turns devices nearby away, the Nearby page says so, and Allow lets them in once Windows asks you.
  • When something else is in the way. If another app, or another copy of Basalt, is using Basalt's nearby port, the Nearby page says so and tries again by itself. Bluetooth switched off and on again: Basalt is found again without being reopened.
  • On Linux, devices nearby are found on the same Wi-Fi. Finding them by Bluetooth comes to Linux in a later version.
  • Some phones have Wi-Fi for 2.4 GHz only. With no Wi-Fi in common, they can't yet send to a Windows computer, whose own Wi-Fi is 5 GHz; on the same Wi-Fi they can, and sending to them works either way.
  • On a computer, Settings, Nearby, Show the nearby log has the steps of each share, to look at or send us if one doesn't arrive.

What's new, shown once

  • The first time Basalt opens after updating, a few short moving cards show what's new, with the switches for receiving from devices nearby and staying ready. Settings, About, What's new shows them again.

Ready in the background

  • On a computer, closing the window leaves Basalt in the tray, ready to receive. A notification with Accept and Decline comes when something arrives, and opens Basalt on it.
  • On a phone, Always ready to receive keeps Basalt ready with the app swiped away, with a quiet notification while it is. After the phone restarts or Basalt updates, Android doesn't let it come back by itself: a notification says so, and one tap makes it ready again.

Music together

  • Holds together. Devices playing as one now stay in the group when a phone's Wi-Fi blinks or its screen is off, start together after a pause, and stay in step with the app in the background.
  • Pause, play and seek on any of them reach all of them, and are never undone a moment later.
  • Play on both wakes a device that was paused.
  • A group shows as one. "Laptop +2" plays, and In sync opens who is in it and how close each is, with Stop there, Leave and Stop on all devices.
  • The timeline always moves. After a seek, the line goes straight to the new place, on the device that seeks and on the bar showing another device's song, and never freezes after a touch that slid off it.
  • Another device's song comes back on the bar after a dropped connection, and steering another device shows at once, without flipping back.
  • Sync log. For testing devices playing together, Settings (on a phone, More) has a Sync log, off by default and kept only until Basalt closes.

TV and phone

  • On a TV, starting a song with OK keeps the focus on the song above the music bar, an artist's back arrow no longer sits on the round Play button, the back bar hides what scrolls under it, and the In sync panel closes when nobody else is left in the group.
  • Android 16 no longer asks about location before you reach your drive.
  • A phone on its side: Inbox, Nearby and the photo viewer's bars stay clear of the system's buttons.
  • Phones and tablets leave the music volume to the device's own buttons, also turned sideways; Basalt's own slider is gone there.

Linux

  • Older systems. On Ubuntu 22.04 and other systems with an older WebKit, the window could stay empty or stop updating, so clicks seemed to do nothing, and parts of the film controls could go missing. It now draws reliably there.
  • Films in the AppImage on Ubuntu 26.04 play with their controls; before, they froze the window or played with no controls.
  • The tray and notifications. Where the desktop shows tray icons (Ubuntu, KDE, Linux Mint), closing the window leaves Basalt ready, with Open Basalt, Inbox and Quit in its menu; notifications have Accept and Decline.
  • Share with Basalt from the file manager, for files and folders: in GNOME Files under right-click, Scripts; in Dolphin and Nemo in the menu.
  • The firewall. If ufw or firewalld turns devices nearby away, the Nearby page says so, and Allow asks for your password to let them in.
  • The AppImage now finds the tray, opens files and links with your own apps, and comes back when opened again after closing. If its page fails as it starts, it loads again by itself.
  • Updates start again. From 1.6.4, Basalt and Basalt Host as AppImages start again by themselves after updating.

Fixes

  • Opening a folder on a slow connection shows its rows coming in, rather than the last folder's files under the new folder's name.
  • Two changes saved by the host at the same moment, such as two devices signing in at once, no longer fail with "No such file or directory" or undo each other.
  • A file the host kept for a device now tells its sender it arrived, also when that device takes it as it opens.
  • A file sent from a computer whose firewall keeps the other...
Read more

Basalt v1.6.3

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 30 Oct 14:47
48cffac

Basalt v1.6.3

Music arrives in Basalt: your songs as albums, artists and playlists, playing on while you browse, moving between your devices, or playing on several at once as one. Series learn to skip their intros, films show a picture as you move along the timeline, and the host's own window is redesigned.

Music

  • Albums, artists and playlists. Music reads each song's tags (title, artist, album, cover) and shows your songs as albums and artists, with Liked Songs and playlists of your own. With a profile, likes, playlists and where you were listening follow you to your other devices.
  • Plays on while you browse. A bar along the bottom keeps the song playing while you use the rest of Basalt; open it for the full player, with shuffle, repeat and the queue.
  • On the lock screen and in your system's controls. On Android, the song shows on the lock screen and in the notification, and keeps playing with the screen off. On a computer, the keyboard's media keys and the system's media controls work.
  • Songs without tags. A song named like "Artist - Title (Official Video)" is shown by its artist and title, without the extra words.
  • Album covers and artist photos, if you want them. Switch on Download album covers and artist photos in Manage host: albums and songs without a cover are looked up on MusicBrainz, and their covers fetched from the Cover Art Archive. Artists get their photo from Wikimedia Commons, with the photographer credited on their page, including many Sri Lankan artists. A personal key from a free fanart.tv account, added beside the switch, finds photos for more artists. A photo of somebody else with the same name can be taken down with Wrong person?. Only the names of albums, songs and artists are sent. Off unless you switch it on.
  • Music across your devices. Signed in to the same profile, your other devices see what plays where, with its place moving along, and can pause it, skip it, or take it over: Play here carries on from the same second and stops it there.
  • Play on both, as one. Every song, skip and play after a pause starts on all of them at the same moment, and they stay within a few hundredths of a second of each other, so two speakers in one room sound as one. Any number of devices can join, and pause, play, skip or seek on any of them does it on all.
  • Easy to put away. The music bar slides in and closes (pause first on a phone), the full player slides up from the bar and, on a phone, pulls back down, and the mouse wheel turns the volume.
  • Its own volume. On a computer, music and films each keep their own volume, as you last set it, so a song turned down doesn't make the next film quiet.
  • Waits for the host. If the host can't be reached for a moment, the song waits for it rather than skipping through the queue, and carries on from the same second.
  • Only your music. Recordings, voice notes, and the sounds of programs, games and projects stay in Files, not in Music.

Films and series

  • Skip intro and Next episode. A button during a series' intro skips it, and one at the credits plays the next episode. Basalt finds them from an episode's chapters, or from the music the episodes of a season share, worked out on the host while nothing is playing. Reaching the credits counts as watched.
  • Timeline pictures. Moving along a film's timeline, or holding it on a phone, shows a picture of that moment. The host makes them and keeps them with its own files; choose when in Manage host: as films arrive, while idle, or when first played.
  • Keys on a computer. Enter goes full screen, Esc leaves it, and Esc again goes back to the series or to Movies.
  • Skipping with ±10 s always starts from where you are, and quick presses add up, also while the host converts a film.

Photos and videos

  • Only yours. Sharing a whole drive no longer fills Photos, Videos and Music with the pictures and sounds of installed programs, games and projects. They stay in Files.

The host

  • A new host window. At the top, the host itself: whether it is sharing, who is connected, what it is doing right now, the last minute's traffic, and the drive. Under it, the same panels as Manage host in the app.
  • Connection speed. Settings, under Drive, measures the download, upload and delay between your device and the host, and says what that means for films.
  • Docker: nothing to set. The host in Docker runs as whoever owns the folder you share, so it can add files there without setting PUID and PGID (they still work, to choose another user).
  • When the host can't add files. If its folder doesn't let it write, the host now says so in its window, in Manage host and in basalt-host status, and uploads explain why they are refused.
  • After a restart. When the host restarts, for an update for example, an open app no longer shows empty sections until it is restarted too.
  • When its port is taken. If another copy of the host still holds its port, the host window says so, and starts sharing by itself as soon as the port is free.

Linux

  • Films show their picture on newer systems. On Ubuntu 26.04 and other systems with a recent WebKit, films in the Basalt app played with sound but showed the desktop where the picture should be. The app now draws films the way each WebKit needs.
  • Your home folder first. Setting up Basalt Host on a Linux desktop now offers your own home folder first, with your Videos, Music and Downloads, where uploads work. Before, the only choice on most computers was the whole system disk, which takes no uploads.
  • Found on more networks. Where a network passes the host's announcements but not a device's question, such as a Linux computer in a virtual machine on Wi-Fi, the app listens a moment longer and finds the host. A computer's name typed on its own, such as LIVING-ROOM, is found from Linux too.
  • Known issue: the AppImage on the newest desktops. On Ubuntu 26.04 and systems as new, films in the Basalt app's AppImage may not show their picture. Use the .deb or .rpm there, which work; the AppImage will be fixed in an update.

Installation

Update the computer with the drive first, then your other devices. Basalt 1.6 offers this update by itself, and a host with Update automatically on installs it when nothing is playing or copying. Your pairing, profiles and settings are kept.

File Install on
Basalt-Host-Setup.exe A Windows computer with the drive
Basalt-Host-Linux-amd64.deb, Basalt-Host-Linux-x86_64.rpm, Basalt-Host-Linux-x86_64.AppImage A Linux desktop with the drive
Basalt-Host-Server-Linux-amd64.deb, -arm64.deb, -x86_64.rpm, -aarch64.rpm, .tar.gz A Linux computer with no screen
ghcr.io/refora-technologies/basalt-host:1.6.3 Docker, on a NAS or a home server
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Client-Linux-amd64.deb, Basalt-Client-Linux-x86_64.rpm, Basalt-Client-Linux-x86_64.AppImage Every Linux desktop that connects to it
Basalt on Google Play Android phones, tablets and TVs
Basalt-Android.apk The same Android app, for devices without Google Play, such as Fire TV

Checking a download

SHA256SUMS lists every file's checksum and is signed with Basalt's release key. How to check both is in Checking a download. A .sha256 is still published beside each file.

Windows 10 / 11 · Linux · Docker · Android 8.0+ · Android TV · GPLv3 · © 2026 Refora Technologies

Basalt v1.6.2

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 24 Oct 14:26

Basalt v1.6.2

Basalt is now on Google Play, for phones, tablets and TVs. This release keeps the Google Play and GitHub versions in step, and lets the Android app from GitHub move to Google Play without losing anything. Nothing else changes in how Basalt works.

On Android

  • Moving to Google Play. If you installed the APK from GitHub or the website, Basalt now says it is on Google Play when it offers this update, and lets you choose: Update on Google Play, which installs it over the APK and keeps your drives, profiles and settings, after which Google Play keeps it up to date; or Keep the APK version, which updates as before. You can move later from Settings. Fire TV has no Google Play and updates as before.

Under the hood

  • An updated build tool for the host's window, for its security fixes.

Installation

Update the computer with the drive first, then your other devices. Basalt 1.6 offers this update by itself, and a host with Update automatically on installs it when nothing is playing or copying. Your pairing, profiles and settings are kept.

File Install on
Basalt-Host-Setup.exe A Windows computer with the drive
Basalt-Host-Linux-amd64.deb, Basalt-Host-Linux-x86_64.rpm, Basalt-Host-Linux-x86_64.AppImage A Linux desktop with the drive
Basalt-Host-Server-Linux-amd64.deb, -arm64.deb, -x86_64.rpm, -aarch64.rpm, .tar.gz A Linux computer with no screen
ghcr.io/refora-technologies/basalt-host:1.6.2 Docker, on a NAS or a home server
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Client-Linux-amd64.deb, Basalt-Client-Linux-x86_64.rpm, Basalt-Client-Linux-x86_64.AppImage Every Linux desktop that connects to it
Basalt on Google Play Android phones, tablets and TVs
Basalt-Android.apk The same Android app, for devices without Google Play, such as Fire TV

Checking a download

SHA256SUMS lists every file's checksum and is signed with Basalt's release key. How to check both is in Checking a download. A .sha256 is still published beside each file.

Windows 10 / 11 · Linux · Docker · Android 8.0+ · Android TV · GPLv3 · © 2026 Refora Technologies

Basalt v1.6.0

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 22 Oct 19:01
064b97a

Basalt v1.6.0

Basalt now runs on Linux desktops and on Android TV and Google TV, so your drive opens on every screen in the house. Every release is now signed, and the apps install only an update signed by Basalt's publisher. Series now open where you are. This release also brings subtitles in every script, safer pairing, and many improvements to the phone app. Update the computer that shares the drive first, then your other devices.

Highlights

  • Basalt for Linux. The app now runs on Linux desktops, as a .deb, an .rpm or an AppImage, with the same window and the same mpv player as on Windows. Play in your player hands a film to VLC, mpv, Celluloid, Haruna or Videos. It updates through your package manager, or the AppImage replaces itself.
  • Basalt on your TV. The Android app now runs on Android TV and Google TV, made for the remote: one highlight moves around the library and the files, OK opens and plays, and holding OK opens a film's menu. In the player, OK pauses, left and right skip, and the remote's play, pause, rewind and fast-forward keys work. The TV keeps to watching, and leaves uploads and managing the host to your phone and computer. On a Fire TV, install the APK.
  • Signed releases. Each release's SHA256SUMS is signed with Basalt's release key, which is kept by Refora Technologies and never on GitHub. Basalt Host and the apps install an update only from a release signed with it, for that version, and refuse anything else before downloading it. If one is ever refused, a button offers to report it to us from your own email.
  • Subtitles in every script. On Android, subtitles in any language and script now show, and a new style menu sets their size, font, colour, background and height.

Films and series

  • A series opens where you are. Continue plays the episode you are up to, or the next one, from the top of the page. The season is a heading that opens a list of every season, each saying how much of it you have watched, and finishing a season's last episode opens the next season.
  • Episodes show a picture. Each episode shows a frame made by the host, with how far through it you are, and episodes you have seen to the end are marked Watched.

Pairing and profiles

  • Safer pairing. The PIN is now checked with a password-authenticated exchange (SPAKE2), so someone watching the network cannot work the PIN out afterwards. Devices still on 1.5 keep pairing as before.
  • Claim a new profile with a code. A profile with no PIN yet is claimed with a code the host shows, which you can now copy and send to the person it is for.
  • Paired drives are one tap away. The drive list fits the window however many drives there are, shows them in groups, and lets you forget a paired drive. A computer's name works as well as its address, and typing the address of a drive you already paired with reconnects rather than pairing again.
  • Turning off the PIN asks first. Letting devices join without a PIN now asks you to confirm.

On Android

  • A film keeps playing in a small window when you leave the app, and pauses when you close the window.
  • Made for a finger. Larger touch targets, player controls and menus that fit small phones, and text fields that stay above the keyboard.
  • Android 17 ready. Android 17 asks before an app reaches devices on your home network; Basalt explains why and asks first.
  • More devices. The APK now also carries 32-bit ARM, for TVs and sticks that run it.
  • Moving to Google Play. When an update is also on Google Play, the app from GitHub offers to install it from there, over itself, keeping your drives, profiles and settings; Google Play keeps it up to date after that. You can keep the APK instead, and move later from Settings.

Basalt Host

  • Measuring conversion, step by step. The host measures how many films it can convert at once only when you ask, says what stopped it going higher, and takes the memory free on the computer into account.
  • Devices show as what they are. Device lists show phones, tablets, TVs and computers with their own pictures.

Fixes

  • Turning on Recognise films and series now shows on your devices at once, even on a drive with nothing to recognise yet.
  • Start with Windows could point at the wrong program, so Basalt Host did not start with the computer. It now puts its own entry right when it opens.
  • Basalt on Linux now shows up on the host under the computer's name.
  • Subtitles stayed off after switching tracks while a film was being converted.
  • The subtitle settings stay in view while the list of tracks scrolls.

Installation

File Install on
Basalt-Host-Setup.exe A Windows computer with the drive
Basalt-Host-Linux-amd64.deb, Basalt-Host-Linux-x86_64.rpm, Basalt-Host-Linux-x86_64.AppImage A Linux desktop with the drive
Basalt-Host-Server-Linux-amd64.deb, -arm64.deb, -x86_64.rpm, -aarch64.rpm, .tar.gz A Linux computer with no screen
ghcr.io/refora-technologies/basalt-host:1.6.0 Docker, on a NAS or a home server
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Client-Linux-amd64.deb, Basalt-Client-Linux-x86_64.rpm, Basalt-Client-Linux-x86_64.AppImage Every Linux desktop that connects to it
Basalt-Android.apk Android phones, tablets and TVs, and Fire TV

Updating

Update the computer with the drive first, then your other devices. Basalt 1.5 offers this update by itself, and a host with Update automatically on installs it when nothing is playing or copying. Your pairing, profiles and settings are kept.

Windows

The Windows installers update an existing installation in place. They install per user and do not need administrator rights.

Linux

sudo apt install ./Basalt-Client-Linux-amd64.deb    # the app: Ubuntu, Debian, Linux Mint
sudo dnf install ./Basalt-Client-Linux-x86_64.rpm   # the app: Fedora
sudo apt install ./Basalt-Host-Linux-amd64.deb      # the host: Ubuntu, Debian, Linux Mint
sudo dnf install ./Basalt-Host-Linux-x86_64.rpm     # the host: Fedora

Or make an AppImage executable and open it; the app's AppImage needs the system's mpv library (libmpv2 or mpv-libs). On a computer with no screen, install the package for its processor, or run sudo basalt-host update. The full guide is in packaging/linux/README.md.

Docker

docker compose pull && docker compose up -d

The image is for amd64 and arm64. Setting it up, NAS notes and checking the image's signature are in docker/README.md.

Android

The Android app needs Android 8.0 or later. It is also on Google Play, for phones, tablets and TVs; choosing Update there installs it over the APK, keeping your drives, profiles and settings. Basalt 1.5 offers this update by itself; or open the .apk on the device, and allow your browser or file manager to install it when Android asks.

Checking a download

SHA256SUMS lists every file's checksum and is signed with Basalt's release key. How to check both is in Checking a download. A .sha256 is still published beside each file.

Windows 10 / 11 · Linux · Docker · Android 8.0+ · Android TV · GPLv3 · © 2026 Refora Technologies

Basalt v1.5.1

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 13 Oct 11:19

Basalt v1.5.1

A security and fixes release. It makes pairing and connecting to Basalt Host safer, keeps the host's own settings out of reach, and fixes small things found since 1.5.0. Everyone should update, starting with the computer that shares the drive.

Security

  • Pairing is harder to guess. A host now counts wrong PINs across every device trying to pair, not only within one attempt. After too many, it stops letting new devices in for a few minutes. Someone typing their own PIN wrong never comes near the limit.
  • The host stays up for your devices. Connections that have not signed in are now kept small, short and few, so nothing on your network can slow Basalt Host down or stop your devices connecting.
  • The host's own settings stay private. When the shared folder holds Basalt Host's own settings, as it can when you share a whole home folder or drive, devices can no longer see, open or change them.
  • Programs are not opened from the drive. On Windows, Basalt no longer opens programs straight from the drive. Files downloaded from the drive are marked as downloaded, so Windows asks before running a program and Office opens documents in Protected View, as with files from a browser.
  • Copying a folder leaves links behind. A link inside a copied folder is no longer followed.

Fixes

  • Videos listed the films and episodes that are already in Movies and TV Series. It now shows only your other videos: home videos, clips and recordings.
  • While pairing a phone, a long computer name such as LIVING-ROOM-PC lost its first letter at the edge of the screen. Long names now fit.
  • Before a drive was shared, the profile screen asked "Who is using Vault?". It now names the host.
  • Manage host said Sharing before any drive was shared. It now says No drive shared yet, or Drive not connected when the drive is unplugged.
  • Sharing a drive for the first time asked whether to share it "instead".
  • The hint under Show hidden files only mentioned Windows. It now covers Linux hosts too.
  • A brand new installation showed the notice about updating your other devices. It now only shows when updating from an earlier version.
  • Basalt Host's About now has the same links as the Basalt app, including Send feedback.

Installation

File Install on
Basalt-Host-Setup.exe A Windows computer with the drive
Basalt-Host-Linux-amd64.deb, Basalt-Host-Linux-x86_64.rpm, Basalt-Host-Linux-x86_64.AppImage A Linux desktop with the drive
Basalt-Host-Server-Linux-amd64.deb, -arm64.deb, -x86_64.rpm, -aarch64.rpm, .tar.gz A Linux computer with no screen
ghcr.io/refora-technologies/basalt-host:1.5.1 Docker, on a NAS or a home server
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Android.apk Android phones and tablets

Updating

Update the computer with the drive first, then your other devices. Basalt 1.5.0 offers this update by itself, and a host with Update automatically on installs it when nothing is playing or copying. Your pairing, profiles and settings are kept.

Windows

The Windows installers update an existing installation in place. They install per user and do not need administrator rights.

Linux

On a Linux desktop:

sudo apt install ./Basalt-Host-Linux-amd64.deb      # Ubuntu, Debian, Linux Mint
sudo dnf install ./Basalt-Host-Linux-x86_64.rpm     # Fedora

Or make the AppImage executable and open it. On a computer with no screen, install the package for its processor, or run sudo basalt-host update. The full guide is in packaging/linux/README.md.

Docker

docker compose pull && docker compose up -d

The image is for amd64 and arm64. Setting it up, NAS notes and checking the image's signature are in docker/README.md.

Android

The Android app needs Android 8.0 or later on a 64-bit phone or tablet. Basalt 1.5.0 offers this update by itself; or open the .apk on the phone, and allow your browser or file manager to install it when Android asks.

Checksums

A .sha256 checksum is published beside each file, and SHA256SUMS lists them all.

Windows 10 / 11 · Linux · Docker · Android 8.0+ · GPLv3 · © 2026 Refora Technologies

Basalt v1.5.0

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 10 Oct 20:38

Basalt v1.5.0

Basalt Host now runs on Linux too: on a desktop, or with no screen at all on a home server, a NAS or a Raspberry Pi, set up and managed entirely from the Basalt app. A device can now manage its host from anywhere in the house, every device signs in with a security key of its own, and hosts keep themselves up to date.

What's new

Basalt Host for Linux

  • On a Linux desktop. The same Basalt Host as on Windows, with the same window, for Ubuntu 22.04 and later, Debian 12, Linux Mint 21 and later, Fedora, or any desktop with the AppImage.
  • With no screen. For a home server, a NAS or a Raspberry Pi, Basalt Host runs as a background service that starts with the computer. Packages for 64-bit PCs and ARM boards install on Debian 11 and later, Ubuntu 20.04 and later, Raspberry Pi OS, Fedora and Rocky Linux.
  • Set up from your phone. A host with no screen shows a one-time setup code when it is installed. Choose the host marked new in Basalt, type the code, and that device manages the host from then on. Setting up only ever happens on your own network.
  • In Docker. For a NAS or a home server, Basalt Host is also a Docker image for 64-bit PCs and ARM boards: ghcr.io/refora-technologies/basalt-host. It is signed, and records the GitHub workflow that built it.
  • Plain answers at the computer. sudo basalt-host status shows whether the host is running, its address, what it shares, its devices and the setup code. start, stop, restart and update say what they did.
  • The Basalt app for Linux is next. Until it arrives, open a Linux host's drive from Basalt on Windows or Android.

Manage your host from any device

  • Everything the host's window does. Let a device manage the host, and Manage host on that phone or computer can choose or rename the shared drive, let new devices in, make a device read only, add and remove profiles, and change the library, conversion and section settings. Changes reach every device at once.
  • Browse to share a folder. Choose Choose a folder… and tap through the host's folders, instead of typing a path.
  • Rename the drive. The shared drive can be renamed, from Manage host or from Basalt Host itself, without sharing it again.

Hosts keep themselves up to date

  • Updates go in by themselves. Basalt Host looks for a new version twice a day and installs it when nothing is playing or copying. It restarts by itself, and your devices reconnect. Turn off Update automatically in Basalt Host's settings, or under Updates in Manage host, to install updates yourself.
  • Update now, from anywhere. A device that manages the host can see its version and update it with one press.
  • Starts with your computer. A host set up with 1.5 starts when the computer does, so your devices find it whenever they look. A host set up before keeps its setting: turn on Start when Windows starts (on Linux, Start when you log in) in its settings.
  • Always the official release. Every update is the newest release published here, checked against its published checksum before it is installed. A device can ask for an update, but never choose what is installed.

A security key for every device

  • Signed in with its own key. Each device now signs in with a key created on the device and kept in its security chip when it has one. The key never leaves the device, so a copy of its settings can no longer open your drive.
  • Moves over by itself. Paired devices move to their key the next time they connect, once the host is updated. Devices still on an earlier version keep working, and Basalt Host lists which ones still need updating.

Profiles from your other drives

  • Bring your profile. A profile from one drive can be used on another host. Someone who manages that host lets it in once, and from then on it signs in there with no PIN of its own, while its PIN stays on its own drive.

Clearer everywhere

  • Plain words. Every screen, message and setting in Basalt and Basalt Host was rewritten to say what it means in everyday words.
  • When the host is not running, Basalt now says so plainly, rather than showing a system error.
  • Windows Firewall. If Windows Firewall blocks Basalt Host on your network, the host's window now says so.

Fixes

  • On Android, the keyboard covered fields near the bottom of the screen, such as when adding a profile or renaming.
  • After pairing with a second host, the app still showed the profile signed in on the first.
  • A host's drive name stayed as it was when the device first paired, even after it was renamed.
  • When a device was allowed to manage the host, it only noticed after signing out and in again.
  • A drive chosen from the list in Manage host was named after its whole path rather than its folder.
  • On a computer with several network adapters, the host listed a virtual adapter's address first.

Installation

File Install on
Basalt-Host-Setup.exe A Windows computer with the drive
Basalt-Host-Linux-amd64.deb, Basalt-Host-Linux-x86_64.rpm, Basalt-Host-Linux-x86_64.AppImage A Linux desktop with the drive
Basalt-Host-Server-Linux-amd64.deb, -arm64.deb, -x86_64.rpm, -aarch64.rpm, .tar.gz A Linux computer with no screen
ghcr.io/refora-technologies/basalt-host:1.5.0 Docker, on a NAS or a home server
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Android.apk Android phones and tablets

Updating

Update the computer with the drive first, then your other devices. Basalt 1.4.6 offers this update by itself, at the top of Basalt Host, in the Windows sidebar, and on Android. Devices still on 1.4.6 keep working with a 1.5 host. Once a device is on 1.5, going back to an earlier version on it means pairing it again.

Windows

The Windows installers update an existing installation in place and keep your pairing and settings. They install per user and do not need administrator rights.

Linux

On a Linux desktop:

sudo apt install ./Basalt-Host-Linux-amd64.deb      # Ubuntu, Debian, Linux Mint
sudo dnf install ./Basalt-Host-Linux-x86_64.rpm     # Fedora

Or make the AppImage executable and open it.

On a computer with no screen, install the package for its processor (amd64/x86_64 for a PC, arm64/aarch64 for a Raspberry Pi or other ARM board), for example sudo apt install ./Basalt-Host-Server-Linux-arm64.deb. When it finishes, it shows the host's address, its setup code and anything left to do; sudo basalt-host status shows them again. The full guide is in packaging/linux/README.md.

Docker

With Docker Compose:

services:
  basalt:
    image: ghcr.io/refora-technologies/basalt-host:latest
    container_name: basalt
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - ./config:/config
      - /srv/media:/media/Media
    restart: unless-stopped

Change /srv/media to the folder with your files, then run docker compose up -d. docker exec basalt basalt-host status shows the setup code. The image is for amd64 and arm64, and a container updates when you pull the new image: docker compose pull && docker compose up -d. Settings, NAS setup and checking the image's signature are in docker/README.md.

Android

The Android app needs Android 8.0 or later on a 64-bit phone or tablet. It is not on the Play Store yet: open the .apk on the phone, and allow your browser or file manager to install it when Android asks. That permission is only for installing and can be switched off again afterwards.

Checksums

A .sha256 checksum is published beside each file, and SHA256SUMS lists them all.

Windows 10 / 11 · Linux · Docker · Android 8.0+ · GPLv3 · © 2026 Refora Technologies

Basalt v1.4.6

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 08 Oct 13:27

Basalt v1.4.6

A drive can now be kept private. The owner of Basalt Host decides whether everyone must sign in to a profile, and whether new profiles are added only on the host, and every device follows those decisions the moment they are made. On a phone, the library's sections fit on screen at once, and photo details open as a sheet.

What's new

Private drives

Two new settings in Basalt Host, under Profiles. Both are off unless you turn them on, so a drive works exactly as before until you do.

  • Require a profile. Everyone signs in to a profile before using the drive, and Continue as this device is no longer offered. It can be turned on once at least one profile exists, and removing the last profile turns it off again, so a household can never be locked out of its own drive.
  • Who can add profiles. Choose Anyone using the drive, as before, or Only this host. With Only this host, profiles are added from Basalt Host with a name and a colour, and devices no longer show Add profile.
  • Each person chooses their own PIN. A profile added on the host has no PIN yet. The first time its person signs in, Basalt welcomes them and asks them to choose one, so only they know it, not even the host's owner. Until then, Basalt Host shows that the profile is waiting for its first sign-in.
  • A private drive, together. With both settings on, only the people added on the host can use the drive, each with a PIN of their own. Basalt Host says so under the settings.
  • Enforced by Basalt Host. The rules are kept by Basalt Host itself, not only by the apps. A device that has not signed in can choose a profile and sign in, and nothing else.

Changes reach every device at once

  • No waiting. When the owner changes a setting, adds or removes a profile, or resets a PIN, Basalt Host tells every connected device straight away, over the connection it already keeps open for changes to the drive. A drive made private asks who is using each device within a moment, and a device whose sign-in was ended returns to the profile choice.
  • Nothing about the drive before signing in. On a private drive, a device that has not signed in is not told about changes to the drive, not even the names of new files. Once someone signs in, live updates resume for them.

On a phone

  • Library sections fit on screen. With four or more sections, the chosen one shows its name and the others show their icons, so every section can be reached without scrolling the row. The highlight follows as you swipe between them.
  • Photo details as a sheet. The details of a photo slide up from the bottom, and a swipe down, a tap above the sheet or the back button puts them away. They no longer cover the button that opened them.
  • Back goes where you expect. Back on the pairing PIN returns to the list of computers, and back in the introduction goes one page back, or to the drive list when the introduction was opened from there.

Fixes

  • Photo details on a phone covered their own button, so they could not be closed with it.
  • On a phone with many library sections, some could only be reached by scrolling the row of sections sideways.
  • Continue as this device ends in the same arrow as the app's other rows.

Installation

File Install on
Basalt-Host-Setup.exe The computer with the drive
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Android.apk Android phones and tablets

This release changes Basalt Host and the apps, so update all three. Before making a drive private, update every device that uses it: earlier versions of the apps still offer Continue as this device, which a private drive refuses. Basalt 1.4.5 offers this update by itself, at the top of Basalt Host, in the Windows sidebar, and on Android.

The Android app needs Android 8.0 or later on a 64-bit phone or tablet. It is not on the Play Store yet: open the .apk on the phone, and allow your browser or file manager to install it when Android asks. That permission is only for installing and can be switched off again afterwards.

The Windows installers update an existing installation in place and keep your pairing and settings. They install per user and do not need administrator rights.

A .sha256 checksum is published beside each file.

Windows 10 / 11 · Android 8.0+ · GPLv3 · © 2026 Refora Technologies

Basalt v1.4.5

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 06 Oct 12:17

Basalt v1.4.5

A welcome for people who are new to Basalt, a proper look at what is new when an update arrives, and films that open in your own player without being copied first. Stars now follow you from device to device as soon as you look, and the phone's library turns with a swipe.

What's new

New to Basalt

  • A short introduction. Someone who installs the app on its own now learns first what Basalt is: their own drive on every device, shared by a small free app, Basalt Host, on the computer that has the files.
  • It finds your computer. The introduction looks for Basalt Host on the network while it plays. If one is running, it goes straight to pairing with it. If not, it says how to get Basalt Host (on a phone, send the download link to your computer) and keeps looking, so the computer appears by itself once the host starts.
  • Only for newcomers. It shows on a device that has never been paired. Anyone already using Basalt goes straight to their drive, as before, and the drive list has a link to see it again.

Updates

  • What's new, in full. When an update is ready, the banner, the notification, the Windows sidebar and Settings all open the same window: the release notes, and one button to download and then install it.
  • About, redesigned. The About card in More and in Settings now leads with Basalt Host: on a phone, send the download link to your computer or open the download page; on Windows, download it directly. Send feedback opens an email with the app's version already filled in.

Your own player, on Windows

  • Streamed, never copied. Play in your player now finds VLC, mpv, MPC-HC, MPC-BE, PotPlayer, SMPlayer, KMPlayer and GOM Player wherever they are installed, starting with the one Windows opens that kind of file with. The film starts at once and nothing is written to disk.
  • Open with. A new item in the right-click menu lists the players on the computer, marks the default, and lets any other program be chosen. Tick Always use this player to make it the one Play in your player uses.
  • Asked, not downloaded. If no player can be found, the app asks which to use instead of copying the whole film. Downloading a copy and opening it is still there, as a button that says so.

Stars on every device

  • Up to date when you look. With a profile, Starred is read again each time it is opened and whenever the app comes back to the front, so a star added on the computer shows on the phone, and the other way round.
  • None lost. Each device now changes the list as it stands on the host, rather than writing back its own copy, which could undo a star just added on another device.
  • Marked on Windows. Starred files and folders show a star beside their name in every view, as they already did on a phone.

On a phone

  • Library sections, with a swipe. Movies, TV Series and the other sections are one control, with a highlight that slides to the section chosen. Swiping the page left or right moves between them. Recent and Starred work the same way.
  • Forget this drive has its own place at the foot of More and says which computer it unpairs from.

Fixes

  • Play in your player copied the whole film to disk before playing it when the player was installed somewhere Basalt did not look, such as a second drive.
  • Cancelling a download or upload showed an error, "protocol: cancelled", and counted the transfer as failed. It now says Cancelled.
  • A star added on one device did not appear on another until the app was restarted.

Installation

File Install on
Basalt-Host-Setup.exe The computer with the drive
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Android.apk Android phones and tablets

This release changes the apps; Basalt Host is the same as in 1.4.4 apart from its version number. Updating it as well keeps all three on the same version. Basalt 1.4.4 offers this update by itself, at the top of Basalt Host, in the Windows sidebar, and on Android.

The Android app needs Android 8.0 or later on a 64-bit phone or tablet. It is not on the Play Store yet: open the .apk on the phone, and allow your browser or file manager to install it when Android asks. That permission is only for installing and can be switched off again afterwards.

The Windows installers update an existing installation in place and keep your pairing and settings. They install per user and do not need administrator rights.

A .sha256 checksum is published beside each file.

Windows 10 / 11 · Android 8.0+ · GPLv3 · © 2026 Refora Technologies

Basalt v1.4.4

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 02 Oct 15:30

Basalt v1.4.4

4K that plays on any phone. When a phone or computer cannot play a film smoothly, Basalt Host now converts it as it is watched, and the app says what is happening while it does. Subtitles are found wherever they are on the drive, and TV series are easier to browse on a phone.

What's new

Films your device could not play

  • Converted as you watch. Many phones cannot decode 4K in hardware: a 4K episode stuttered at a few frames a second and drifted away from its sound. Basalt now notices when a device cannot keep up, and Basalt Host converts the film to 1080p as it plays, with the sound and subtitles left untouched. Measured on a phone whose decoder stops at 1440p, a 4K 10-bit episode went from 8 frames a second to a steady 24, with none dropped.
  • Said, not hidden. While the host prepares the film, the screen says Optimizing and why, rather than looking stuck. Once a device has struggled with a size of picture, the next film that size starts converted straight away, without trying the original first.
  • Your choice of picture. A new quality button beside the subtitles shows what is playing, 1080p or the original, and switches between them at the same moment in the film.
  • Seeking works anywhere. Jumping to any point in a converted film starts the conversion from there. Moving on to the next episode, or seeking again before the last seek has opened, no longer finds the host busy with your own earlier request.
  • Picks up where it stopped. If Basalt Host is closed, its computer sleeps, or the Wi-Fi drops mid-film, the app says it is picking the film up again and carries on from the same moment once the host is back. If the host stays away, it says so and offers Try again, instead of stopping as if the film had ended.
  • When the host cannot convert. If converting is switched off, the host's computer is too slow, or it is already converting for as many devices as it can, a phone plays the film in a lighter mode and says why. The picture is a little softer, and the sound stays in step.

Converting on Basalt Host

  • Included in the installer. Basalt Host now installs the ffmpeg it converts with. There is nothing else to download.
  • Uses the fastest hardware there is. NVIDIA graphics first, then Intel graphics, then the processor, which is tuned to do as little work as the picture allows so that older computers keep up.
  • Knows how much it can do. The host measures how many films its computer can convert at the same time, and shows it in Settings, with what is being converted and for which device. The number can also be set by hand, and converting can be switched off altogether.

Subtitles, wherever they are

  • No folders needed. A subtitle anywhere on the drive, named for the same film and year or the same show and episode, is matched to its video. Videos played from Files get their subtitles too.
  • Others nearby, by hand. Subtitles in the same folder that might belong to a video are offered in the subtitle menu, and the one chosen is remembered.
  • Menus that fit. The subtitle menu scrolls when there are many. A click on the film closes either menu, and on a phone the back button closes an open menu before it closes the film.

TV series on a phone

  • Sideways. Held sideways, a series shows its poster beside the episode list, so the list has the whole height of the screen.
  • Upright. Scrolling down the episodes shrinks the poster into the corner, leaving more room for the list.
  • Episode names. An episode known only by its file shows the episode's own name, such as "Low Water", instead of the whole release name.

Fixes

  • The first video played on a phone after pairing could play its sound with no picture.
  • Show hidden files in Settings now lines up with the other rows.

Installation

File Install on
Basalt-Host-Setup.exe The machine with the drive
Basalt-Client-Setup.exe Every Windows PC that connects to it
Basalt-Android.apk Android phones and tablets

Update the host and your devices: converting needs both the new Basalt Host and the new apps. Older apps keep working with the new host, and the new apps with an older host, without converting. Basalt 1.4.3 offers this update by itself, at the top of Basalt Host, in the Windows sidebar, and on Android.

The Android app needs Android 8.0 or later on a 64-bit phone or tablet. It is not on the Play Store yet: open the .apk on the phone, and allow your browser or file manager to install it when Android asks. That permission is only for installing and can be switched off again afterwards.

The Windows installers update an existing installation in place and keep your pairing and settings. They install per user and do not need administrator rights.

A .sha256 checksum is published beside each file.

Windows 10 / 11 · Android 8.0+ · GPLv3 · © 2026 Refora Technologies

Basalt v1.4.3

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 02 Oct 05:50

Basalt v1.4.3

A steadier Basalt. Changing drive now shows the new drive's films and series straight away, files with unusual names behave as they do in Explorer, Windows' own hidden files stay out of sight, and a drive that stops sharing is waited for and opens by itself when it is back.

Change drive, done properly

  • The new drive's library, at once. After changing drive, Movies, TV Series, Videos, Music and Photos could keep showing the last drive's titles for a while before the new drive's appeared. They now start empty and fill with the new drive's own, on Windows and Android alike. Continue watching, stars and profiles follow the drive in the same way.
  • A host that changes drive mid-scan. If the drive on the host was changed while it was still looking through the old one, that scan could finish and file the old drive's films under the new drive until the next scan. A scan now stops when its drive is no longer the one served, and the new drive is scanned straight away.
  • A drive that does not answer. Choosing a drive whose computer is asleep or off the network used to leave the screen waiting for up to two minutes with nothing said. Basalt now gives up after a few seconds, looks for the host on the network once more, and then says what to check.

Files as Explorer has them

  • Hidden files stay hidden. Items Windows keeps out of sight, such as desktop.ini, Thumbs.db and the Recycle Bin, are no longer listed. To see them, turn on Show hidden files in Settings → Files on Windows, or under More on Android.
  • Nothing from hidden folders in the library. Pictures and videos inside hidden folders, such as a browser's cache under a shared user folder, no longer turn up in Photos, Videos or Recent, whether found by a scan or as they arrive.
  • Names Windows will not take are explained first. Creating or renaming to a name Windows refuses, such as one with ? or : in it, ending in a dot, or a reserved name like CON, now says why before anything is tried, instead of failing with a code.
  • Changing only the capitals of a name works. Renaming holiday plans.txt to Holiday Plans.txt used to be refused as if the name were taken.
  • Clear messages for two common problems. A file open in another program on the host, and a drive that is full, are now said in words, with what to do about them.

Steadier connections

  • A drive that stops sharing is waited for. If Basalt Host is closed, or its computer switched off, the app now says which drive it is waiting for and keeps trying, and the drive opens by itself within seconds of sharing again. This works whether the app was open at the time or opened afterwards. It used to try once and give up, and an app opened meanwhile showed an empty folder until it was restarted.
  • No "Who is using" after a dropped connection. When the connection drops and comes back, the app carries on as whoever was using it, including a profile signed in without "remember" and "continue as this device" chosen for now. It used to ask again, in the middle of whatever was playing.
  • A connection that dies quietly is noticed. When Wi-Fi drops or a laptop sleeps mid-transfer, nothing tells the other end. Both the apps and the host now start checking a connection after fifteen seconds of silence, so a stalled transfer or folder fails and retries instead of waiting indefinitely.
  • Posters load as you scroll. In a large library, posters load as their cards come near the screen, a few at a time, rather than all at once when Movies opens, and only the most recent few hundred are kept in memory.

Installation

File Install on
Basalt-Host-Setup.exe The machine with the drive
Basalt-Client-Setup.exe Every Windows PC that connects to it
Basalt-Android.apk Android phones and tablets

Update the host and your devices: some of these fixes are in Basalt Host, and some in the apps. Basalt 1.4.2 offers this update by itself, at the top of Basalt Host, in the Windows sidebar, and on Android.

The Android app needs Android 8.0 or later on a 64-bit phone or tablet. It is not on the Play Store yet: open the .apk on the phone, and allow your browser or file manager to install it when Android asks. That permission is only for installing and can be switched off again afterwards.

The Windows installers update an existing installation in place and keep your pairing and settings. They install per user and do not need administrator rights.

A .sha256 checksum is published beside each file.

Windows 10 / 11 · Android 8.0+ · GPLv3 · © 2026 Refora Technologies