Skip to content
refora-technologiesPublic

About

Your home drive, on every screen in the house. Basalt Host runs on Windows, Linux or Docker and shares one drive with every phone, tablet, TV and computer you own: encrypted, with a built-in player, and private by default. By Refora Technologies.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Basalt

Basalt

Your home drive, on every screen in the house.
Yours, encrypted, and private by default.

Windows 10/11 Linux: host and app Docker: amd64 and arm64 Android 8.0+ and Android TV License Release Downloads

Host for Windows  ·  Host for Linux  ·  Basalt for Windows  ·  Basalt for Linux  ·  Basalt on Google Play

basalt.reforatech.com  ·  Docs  ·  Release notes  ·  Refora Technologies


Basalt for Windows: the Movies library, with Continue watching

Overview

Basalt by Refora Technologies turns one computer into a private drive for the whole household. Basalt Host runs on the computer with the drive: Windows or Linux, with a screen or without one, such as a home server, a NAS or a Raspberry Pi. Basalt runs everywhere else, on Windows and Linux computers and on Android phones, tablets and TVs. Every device browses the same files, watches the same library, and picks up where the last one left off.

There is nothing to configure. You choose a drive on the host; on another device you choose the host from a list and type the PIN it shows. That is the whole setup. No address is ever typed and no account is made. Devices find the host by themselves, and keep finding it when the router gives it a different address, because they recognise the host itself rather than where it happens to be today.

Your files stay yours: the host serves them to your devices over your own network, encrypted, and that is all it does.

Screenshots

The player, with subtitles Photos, in rows by month
The player: streamed from the drive, every format, every subtitle track Photos from every folder, by month, at their own shape

Basalt for Android: files, the library, a series and photos
Basalt for Android: the same drive, library and profiles, laid out for touch

Basalt Host: the shared drive, a device asking to join, and who is connected
Basalt Host: the shared drive, a new device asking to join, and everyone connected

Key Features

Set up once, then forget it

  • Finds itself. The host announces itself on your network and every device lists what it finds. If a network blocks that, a device can be given the host's address instead.
  • Nobody joins without your say-so. A new device shows a PIN to type, once. After that it simply connects, and the host can make any device read only or remove it.
  • Manage it from your phone. Let a device manage the host, and it can do everything the host's own window does: choose or rename the drive, browse the host's folders to share one, let devices in, add profiles and change settings.
  • Hosts with no screen. On a server, a NAS or a Raspberry Pi, Basalt Host runs as a background service or in Docker. It shows a one-time setup code; the first device to type it manages the host from then on.
  • A drive that comes and goes. Unplug the host's drive and every device says so; plug it back in and it is shared again, with nothing to redo.
  • Keeps itself up to date. The host installs new versions by itself when nothing is playing, and the apps show what changed before they update. Every release is signed, and an update that isn't signed by Basalt's publisher is refused before it is downloaded.

Private by design

  • Encrypted, and sure of the host. Every connection is encrypted, and each device remembers the host it paired with, so a different computer at the same address is refused rather than trusted.
  • A key for every device. Each device signs in with its own key, created on the device and kept in its security chip when it has one. It never leaves the device, so a copy of its settings can't open your drive.
  • Private by default. Files travel between your own devices and nowhere else, and nothing tracks what you open. The only requests that leave your network are the update check, to GitHub, and, if you turn them on, poster lookups and album covers and artist photos.
  • Careful with what it keeps. Profile PINs are stored only as slow, salted hashes, and repeated wrong guesses lock a profile for longer each time.

The whole drive, from anywhere in the house

  • Browse everything. Files, folders, search, copy, move, rename, delete, and select several by dragging a box around them.
  • Upload the easy way. Drop files or whole folders onto the folder you want. On a phone, upload from the gallery, any file or a folder, or share to Basalt from any other app.
  • Fast and checked. Transfers are compressed where that helps, batched for small files, and checked end to end so every file arrives exactly as it was.
  • Live. A file added, renamed or deleted on the host, by Basalt or anything else, reaches every connected device at once.

Films and series, filed for you

  • Recognised automatically. Turn it on and the host files the films and series on the drive under Movies and TV Series, with seasons and episodes in order, and new ones the moment they are copied in. Every film is checked against a bundled catalogue of released titles, offline, so screen recordings and home videos stay out of Movies.
  • Posters and picture quality. Optional posters need no API key. Films, series and episodes are tagged HD, Full HD, 2K or 4K from the video itself, not from its file name.
  • Continue watching. Resume points live on the host, so a film started on the laptop finishes on the phone, and episodes play on to the next one.
  • Photos, music and home videos. The host finds every photo, song and video on the drive, however deep, and sorts each into its own section. Photos are laid out by month at their own shape with a viewer that zooms; videos show a picture from inside them. Thumbnails are made once, on the host, and shared by every device. The pictures and sounds of installed programs, games and projects stay in Files.
  • Choose what devices show. The host decides which sections appear on your devices. Hiding one only tidies the list; every file is still in Files.

Music in every room

  • Albums, artists and playlists. Songs are shown by their tags as albums and artists, with Liked Songs and playlists that follow your profile. A song without tags is named from its file, and recordings and voice notes stay out of Music.
  • Plays on while you browse, with the keyboard's media keys, the lock screen and the system's own controls, and a volume of its own.
  • In step on several devices. Play on two or more devices at once and they start together and stay within a few hundredths of a second of each other, so two speakers in one room sound as one. Any of them pauses, skips or seeks for all, and another device can take the song over from the same second.
  • Covers and artist photos, if you want them, from MusicBrainz, the Cover Art Archive and Wikimedia Commons, crediting the photographer, with an optional fanart.tv key for more.

A real player

  • Plays what a browser cannot. Built on mpv, on Windows, Linux and Android alike, so HEVC, HDR, E-AC3, DTS, MKV and the rest play straight from the drive, with nothing downloaded first.
  • Plays on any phone or TV. When a device cannot keep up with a film, the host converts it to 1080p as it plays, on its graphics where it has them, with the sound and subtitles untouched. The player says so while it prepares, picks the film up again if the connection drops, and a quality button switches back to the original at any time. The host measures how many films its computer can convert at once, and converting can be switched off.
  • Subtitles done properly. Tracks named by language, remembered on or off from one video to the next, found anywhere on the drive by the film's or episode's name or dropped onto the video, and nudged into sync when they drift.
  • Skip intro, and a picture on the timeline. Series skip their intros, found from chapters or from the music a season's episodes share, and offer the next episode at the credits. Moving along the timeline shows a picture of that moment.
  • Made for the keyboard. Space to pause, arrow keys to seek and change volume, Enter for full screen and Esc to leave it, C for subtitles, Shift+P and Shift+N for the previous and next episode, and , and . to step one frame at a time. Pausing shows what is playing and what comes next.

Profiles for the household

  • Everyone gets their own. A profile is a name, a colour and a PIN. Its Continue watching and starred files follow it to every device, and "keep me signed in" means typing the PIN once per device.
  • Or skip it. Carry on as the device, with a history of its own.
  • Managed from the host. See who is signed in where, reset a forgotten PIN, or remove a profile along with its history.
  • Bring your profile. A profile made on one drive can be used on another host too, once someone who manages that host lets it in. Its PIN stays on its own drive.

On your phone and tablet

  • The same app, laid out for touch. Tabs along the bottom on a phone and a rail down the side on a tablet; tap to open, long-press to choose several.
  • Films in your hand. Full screen, turned to suit the picture, with a double tap either side to skip. Or hand the stream to another player such as VLC.
  • Photos by touch. Pinch to zoom, swipe to the next, swipe down to put it away.
  • Carries on with the screen off. A transfer or a song keeps going while the phone is locked, and downloads land in the phone's Download folder.
  • Stays on the Wi-Fi. On a Wi-Fi network without internet access, where a phone would normally switch to mobile data, Basalt keeps its connection to the host.

On your TV

  • The same app, made for the remote. On Android TV and Google TV the arrows move one highlight 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.
  • Keeps to watching. The TV opens on the library, and leaves uploads, downloads, sharing and managing the host to your phone and computer.
  • Pauses when you leave. Press Home during a film and it waits for you, or carries on in a small window on a TV that has one.

Several devices at once

There is no device limit and no connection limit. The host serves bytes and nothing more, so more viewers cost it almost nothing.

Technical Stack

Part Built with
Host and client cores Rust 2024, Tokio
Transport TCP, TLS 1.3 (rustls + ring), SPKI pinning, custom binary protocol
Discovery UDP beacon on the local network
Desktop apps Tauri v2, React 19, TypeScript, Tailwind, Framer Motion
Android app Tauri v2 mobile, the same React interface, a Kotlin plugin
Playback and thumbnails libmpv, on Windows, Linux and Android
Film recognition A bundled catalogue of film and series titles from Wikidata
Integrity BLAKE3 per transfer; updates by SHA-256, signed with Basalt's release key

Installation

Download the latest version. These links always give the newest release. To check what you downloaded, the releases page has a signed SHA256SUMS; SECURITY.md says how.

Basalt, on every device that should reach the drive:

Download Install on
Basalt-Client-Setup.exe Windows computers
Basalt-Client-Linux-amd64.deb Ubuntu 22.04 or later, Debian 12, Linux Mint 21 or later
Basalt-Client-Linux-x86_64.rpm Fedora and similar
Basalt-Client-Linux-x86_64.AppImage Any other Linux desktop
Basalt on Google Play Android phones, tablets, Android TV and Google TV (Android 8.0 or later)
Basalt-Android.apk The same Android app, for devices without Google Play, such as Fire TV

Basalt Host, on the computer with the drive:

Download Install on
Basalt-Host-Setup.exe Windows
Basalt-Host-Linux-amd64.deb Ubuntu 22.04 or later, Debian 12, Linux Mint 21 or later
Basalt-Host-Linux-x86_64.rpm Fedora and similar
Basalt-Host-Linux-x86_64.AppImage Any other Linux desktop

Basalt Host with no screen, for a home server, a NAS or a Raspberry Pi:

Download Install on
Basalt-Host-Server-Linux-amd64.deb Debian 12 or later, Ubuntu 22.04 or later
Basalt-Host-Server-Linux-arm64.deb Raspberry Pi OS (64-bit) and other ARM boards
Basalt-Host-Server-Linux-x86_64.rpm, aarch64.rpm Fedora, Rocky and similar
Basalt-Host-Server-Linux-x86_64.tar.gz, aarch64.tar.gz Anything else, installed by hand

With Docker, for a NAS or a home server (amd64 and arm64):

docker pull ghcr.io/refora-technologies/basalt-host:latest

The compose file and settings are in docker/README.md. Every image is signed and carries a record of the workflow that built it, which gh attestation verify oci://ghcr.io/refora-technologies/basalt-host:latest --owner refora-technologies checks.

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

On Android, Google Play installs Basalt and keeps it up to date, on phones, tablets and TVs alike. The .apk is the same app for devices without Google Play: open it and allow your browser or file manager to install it when Android asks; that permission is only for installing, and can be turned off again afterwards. On a Fire TV, the Downloader app fetches the .apk from its link. Already using the .apk? Choose Update on Basalt's Google Play page: it installs over the .apk, keeping your drives, profiles and settings.

On Linux, install the .deb or .rpm with your package manager, for example sudo apt install ./Basalt-Client-Linux-amd64.deb; it updates through it too. The AppImage needs no installing: make it executable and open it, and it replaces itself when there is a new version. It needs FUSE 2, which Ubuntu 24.04 and later leave out: if it does not open, sudo apt install libfuse2t64 once.

Getting started:

  1. Install Basalt Host on the computer with the drive, open it, and choose the drive to share.
  2. Open Basalt on another device. It lists the host; choose it.
  3. Type the PIN the host shows. Done.

With no screen: install the package, for example with sudo apt install ./Basalt-Host-Server-Linux-amd64.deb. It finishes by showing the host's address and a setup code. Open Basalt on your phone or computer, choose the host marked new, and type the code. That device then manages the host: choose what it shares in Manage host. Run sudo basalt-host status to see it all again; the full guide is in packaging/linux/README.md.

Step-by-step guides for every kind of host, pairing, the library, the player, profiles, Manage host and troubleshooting are in the docs.

Basalt Host updates itself when nothing is playing; you can turn that off in its settings or in Manage host. The apps check for updates on their own and show what is in the new version before you install it. On Android the update is downloaded, checked against the release's signed checksums, and handed to Android's own installer; the first time, Android asks you to allow Basalt to install it.

Configuration & Usage

Everything Basalt keeps lives in %APPDATA%\Basalt\ on Windows, ~/.config/basalt/ on a Linux desktop, and /var/lib/basalt-host/ for the host with no screen:

File What it is
host.json The host's identity, settings, paired devices and profiles
client.json The drive this device is paired with
host.log The host's log, replaced at each start
library-*.json, collections-*.json The media index, rebuilt by a scan
watched-*.json, stars-*.json Watch history and starred files, per device and per profile
resolutions-*.json Each video's measured picture size
thumbs/, art/ Thumbnails, and downloaded posters

Deleting host.json regenerates the host's identity, which un-pairs every device and removes its profiles. The rest can be deleted freely and is rebuilt as needed, apart from watch history and stars.

On Android the app keeps what it needs in its own private storage, which is left out of phone backups, so its pairing never travels to another device. Clearing the app's storage, or Forget this drive under More, means pairing again.

Optional, and off by default: recognising films and series reads the whole drive, and downloading posters sends the titles of recognised films and series to an online service to find their posters. Neither happens until you turn it on, in Basalt Host or in Manage host.

Building from source

rustup toolchain install stable          # Rust 1.98+ MSVC
cd apps/client/src-tauri && pwsh -File fetch-libmpv.ps1
cd apps/host/src-tauri   && pwsh -File fetch-libmpv.ps1 && pwsh -File fetch-ffmpeg.ps1
cd apps/client && npm install && npx tauri build
cd apps/host   && npm install && npx tauri build

fetch-libmpv.ps1 downloads libmpv and a small wrapper into src-tauri/lib/ and verifies the wrapper's checksum. They are not in the repository because libmpv-2.dll is 96 MB. The host uses the same libmpv to make thumbnails of videos; its script copies the client's rather than downloading it again.

fetch-ffmpeg.ps1 puts ffmpeg into the host's src-tauri/lib/, checked against the checksum its builder publishes. The host uses it to convert video for a device that cannot play a file itself.

The host recognises films against a catalogue of every film and series title on Wikidata, bundled so that it works offline and sends nothing anywhere. It is committed at crates/basalt-catalog/data/catalog.bin (about 3 MB) and rebuilt for each release with:

cargo run -p catalog-build --release

cargo test --all runs the Rust suite; npm test in either app runs its own.

Linux packages

On Linux with Docker:

packaging/build-desktop-linux.sh OUT_DIR   # Basalt Host with a window: .deb, .rpm, AppImage
packaging/build-client-linux.sh OUT_DIR    # the Basalt app: .deb, .rpm, AppImage
packaging/test-shells-linux.sh             # the app shells' own tests, which cargo test --all leaves out
packaging/build-server.sh OUT_DIR          # with no screen: .deb, .rpm, .tar.gz, amd64 and arm64
docker build -f docker/Dockerfile -t basalt-host .

Each builds inside an older system's container, so the desktop apps run on Ubuntu 22.04, Debian 12 and everything newer, and the host with no screen on Debian 11 and Ubuntu 20.04 as well.

The Android app

It needs the Android SDK with NDK 28, JDK 17, and Rust's Android targets:

rustup target add aarch64-linux-android armv7-linux-androideabi x86_64-linux-android i686-linux-android
set NDK_HOME=%LOCALAPPDATA%\Android\Sdk\ndk\28.2.13676358
set JAVA_HOME=C:\Program Files\Java\jdk-17
cd apps/client && npx tauri android build --apk --target aarch64 --target armv7

A release carries 64-bit and 32-bit ARM: phones are 64-bit, but many televisions and TV sticks run 32-bit Android. The build stops if a --target is missing, rather than make an app some devices cannot start.

The phone's player is mpv too, from the dev.jdtech.mpv:libmpv package, which Gradle fetches by itself; the desktop's Windows libraries are left out.

Release builds are signed with a key kept outside the repository. Gradle reads its location and passwords from %USERPROFILE%\.basalt\android-signing\keystore.properties, or from the file BASALT_SIGNING names:

storeFile=D:/path/to/basalt-release.keystore
storePassword=...
keyAlias=basalt
keyPassword=...

Without it the build is left unsigned. Keep the key safe: Android installs an update only over an app signed with the same key.

npx tauri android build --debug --apk --target x86_64 builds for the emulator. After regenerating icons with npx tauri icon, run python tools/make-icons.py again so the Android project has its own.

Community

License

This project is licensed under the GNU General Public License v3.0 (GPLv3).

You are free to use, modify and distribute this software, provided any derivative works are also open-source under the identical terms. See the LICENSE file for the complete terms.

Basalt bundles libmpv (LGPL-2.1-or-later) — and, in the Android app, the libmpv-android build of it — and links a number of open-source libraries. See THIRD-PARTY-NOTICES.txt for full attribution.


Crafted by Refora Technologies

basalt.reforatech.com  ·  reforatech.com

About

Your home drive, on every screen in the house. Basalt Host runs on Windows, Linux or Docker and shares one drive with every phone, tablet, TV and computer you own: encrypted, with a built-in player, and private by default. By Refora Technologies.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages