Share a drive
Install Basalt Host on the computer with your files, films and photos, and choose the drive to share. On Windows, Linux, or a NAS.
Basalt turns your computer into a private drive for the whole household. Browse every file, stream every film, photo and song, pass files between your devices, and pick up where you left off on any computer, phone, tablet or TV in the house. Your files stay on your own drive, private by default.
No IP addresses and no sharing settings. Your devices find the host by themselves, and keep finding it when the router hands it a new address.
Install Basalt Host on the computer with your files, films and photos, and choose the drive to share. On Windows, Linux, or a NAS.
Open Basalt on a laptop or phone. The first time, it shows how it works and finds the host for you. There is nothing to type.
The host shows six digits. Type them on the device and it is paired for good. That is the whole setup.
The computer with the drive can be the one on your desk, a home server in a cupboard, or a NAS. Basalt Host runs on all of them, and every device sees the same drive.
The computer on your desk. Basalt Host has a window of its own and waits in the notification area.
The same Basalt Host, with the same window, on Ubuntu, Debian, Linux Mint, Fedora and more.
With no screen at all. It runs in the background, starts with the computer, and is set up from your phone.
One container for Synology, Unraid, TrueNAS, QNAP or a server of your own.
$ sudo basalt-host status ● Basalt Host 1.6.4 is running Name home-server Address 192.168.1.20:7742 Identity 3fa91c07 Version 1.6.4 Sharing Media (/srv/media) Devices none yet ┌─ Set it up ──────────────────────────────────────────┐ │ │ │ Setup code K7QF-M2XR │ │ │ │ Open Basalt on your phone or computer, on this │ │ network, choose "home-server" and type the code. │ │ That device will manage the host. │ │ │ └──────────────────────────────────────────────────────┘
A host with no screen shows a one-time setup code. Choose the host marked new in Basalt, type the code, and that device manages the host from then on.
Choose or rename the drive, browse to a folder, let devices in, add profiles and change any setting from your phone or laptop, with Manage host.
The host installs new versions by itself when nothing is playing, and your devices reconnect on their own.
So the drive is there whenever your devices look for it.
Not a film server: your whole drive. Every folder, document, photo, song and home video on it, from every screen, kept in step the moment anything changes.
Every folder on the drive, from any computer or phone. Drag a box to select, and drop files or whole folders in to upload them. Transfers are compressed where it helps and verified end to end.
Add, rename or delete a file on the host, with Basalt or anything else, and every device sees it straight away.
A profile is a name, a colour and a PIN. Its Continue watching and starred files follow it to every device. Or skip it and carry on as the device.
See every device and what it is streaming right now. Make one read only, let one go, reset a forgotten PIN, and choose which sections devices show. On the host, or from your phone with Manage host.
There is no device limit and no stream limit. Most of the time the host simply sends files, so an ordinary computer is enough and more viewers cost it almost nothing.
Send any file or a whole folder from one device to another: 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.
Choose Share on anything, on the drive or on the device itself, and pick where it goes. Your own devices take it at once; anyone else in your home is asked first.
Share with a device nearby reaches a guest’s phone or a friend’s laptop, before any drive is set up. Each shows by name and a short code, so two phones of the same model are told apart.
A shared folder lands with all its folders inside. Sent twice, it arrives beside the first, never mixed in.
The host keeps the file, locked, and delivers it when that device is back, kept apart from the drive.
Close Basalt on a computer and it waits in the tray; on a phone, Always ready to receive. A notification asks when something comes.
Share with Basalt from File Explorer and the Linux file managers, and from Android’s Share menu.
The sender sees it accepted, moving and arrived. A dropped connection picks up again, and Stop ends a send.
Every share is encrypted, and none of it goes through the internet. No account, and no server in between.
Basalt reads your drive and puts every film and episode in its place, with posters, picture quality and a Continue watching row that follows you from room to room.
Switch it on and the host files films under Movies and series under TV Series, with seasons and episodes in order. New ones appear the moment they are copied in.
Every film is checked against a bundled catalogue of real titles, so screen recordings and home videos stay out of Movies. Nothing is sent anywhere to do it.
HD, Full HD, 2K or 4K, measured from the video itself rather than guessed from its file name.
Start a film on the laptop and finish it on the phone. Episodes play on to the next one by themselves.
Built on mpv, the player enthusiasts trust, on Windows, Linux and Android alike. Films stream straight from the drive in their original quality, with nothing copied first. And when a phone cannot keep up with a 4K film, the host makes it play smoothly.
Some films are too much for a phone to play smoothly. Basalt notices, and the host converts the film to 1080p as it plays, sound and subtitles untouched, picking up again if the connection drops. A quality button switches back.
Matched to the video by name wherever they are on the drive, named by language, remembered from one video to the next, and nudged into sync when they drift.
Resume points live on the host, so a film started on the laptop carries on from the same moment on the phone, for every profile.
On Windows, a film streams straight to VLC, PotPlayer, mpv or MPC, or any player you choose. On a phone, to any player installed. Nothing is copied first.
A button skips a series' intro, and another at the credits plays the next episode. Moving along the timeline shows a picture of that moment.
Every control has a key, on Windows. On a phone, double-tap either side to skip.
The songs on your drive as albums, artists and playlists, playing on while you browse. Take a song from one device to another, or play it on several at once, in step.
Play on two or more devices at once and they start together and stay within a few hundredths of a second, so two speakers in one room sound as one, and they hold together when a phone’s Wi-Fi blinks or its screen goes off. Any of them pauses or skips for all.
Your other devices see what plays where. Play here carries the song on from the same second, and your likes, playlists and place follow your profile.
Albums without a cover can get theirs, and artists their photo, credited to whoever took it. Off unless you switch it on, and only names are sent.
The same drive, library and profiles as on your computer, laid out for touch, with sections you swipe between. It pairs the same way, finds the host by itself, and plays films on the same player.
Upload from the gallery, any file, or a whole folder. Or share from any other app, to the drive, another of your devices, or a phone nearby.
Full screen, turned to suit the picture, with a double tap either side to skip. A film the phone can't play smoothly is converted by the host as you watch. Or hand the stream to another player such as VLC.
Pinch to zoom, swipe to the next one, and swipe down to put the viewer away.
A transfer or a song keeps going while the phone is locked, and Always ready to receive tells you when a file comes. Downloads land in the phone’s Download folder.
On a Wi-Fi network without internet, where a phone would normally switch to mobile data, Basalt keeps its connection to the host.
New versions show what is new, download inside the app, and are checked before they install.
Your files stay on your own drive. The host serves them to your own devices, over your own network, encrypted, and that is all it does.
Every connection is encrypted. Each device remembers the host it paired with, so a different computer pretending to be your host is refused.
By default, a new device needs the PIN the host shows. Any device can be made read only, or removed.
Each device signs in with a key of its own, 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.
Files travel between your own devices, or to a device nearby once its owner says yes, and local stays the default. No telemetry, and profile PINs are kept only as salted hashes.
Licensed under the GPLv3, with the source code public for anyone to read.
Every update is the newest official release, signed by Basalt’s publisher and checked before it goes in. A device can ask the host to update, but never choose what is installed.
The film shows Basalt at home with an example household. The tutorials walk through each part, from setting it up to sharing files, and each one has a written guide beside it.
1:12
The film
Basalt in a minute
2:08
Tutorial 1
Set up Basalt
1:58
Tutorial 2
With no screen
1:22
Tutorial 3
In Docker on a NAS
1:31
Tutorial 4
Films and series
1:12
Tutorial 5
Profiles
1:12
Tutorial 6
Photos, music, videos
1:14
Tutorial 7
Manage host
1:05
Tutorial 8
Your files
1:07
Tutorial 9
Privacy and security
Something else on your mind? The docs cover setting up and using Basalt step by step, and the community answers questions on GitHub.
One computer with the drive you want to share, running Basalt Host: a Windows 10 or 11 computer, a Linux desktop, or a home server, NAS or Raspberry Pi with no screen at all. Then Basalt on your other devices: Windows 10 or 11 and Linux computers, and Android phones, tablets and TVs running Android 8.0 or later, on the same home network.
The drive can be the computer’s own, one plugged in over USB, or any folder on it.
Yes. Basalt Host runs on the computer with your files and shares them. Basalt opens them on every other device, and on that computer too if you like.
Basalt on its own has nothing to show until a host is running. The first time it opens, it explains this, shows how to get Basalt Host, and finds the host for you once it is running.
Yes. On a home server, a NAS or a Raspberry Pi, Basalt Host runs in the background as a Linux service or in Docker, and starts with the computer.
When it is installed, it shows a one-time setup code. Open Basalt on your phone or computer, choose the host marked new, and type the code. That device then manages the host with Manage host: what it shares, who can join, and every setting.
No. Basalt is your whole drive: every folder and file, to browse, upload, download, copy and move, from every screen. Photos, music and home videos get views of their own, and films and series get a library with posters and Continue watching.
Yes, from version 1.6.4. Choose Share on any file or folder, on the drive or on the device itself, and pick another of your devices or someone else’s in your home. Your own devices take it at once; anyone else is asked first.
When both devices are on, files go straight across. When one is away, the host keeps them, locked, and delivers them when it is back.
Yes. Share with a device nearby reaches phones and computers around you that aren’t on your host, even before any drive is set up. With no Wi-Fi in common, they find each other by Bluetooth, and the receiving device opens a small Wi-Fi of its own just for that transfer. Nothing arrives without the other person’s yes, and every share is encrypted.
On Linux, devices nearby are found on the same Wi-Fi for now.
Yes. Basalt is free to download, and everything it does today is free, with no advertising. The source code is public under the GPLv3.
No. Your files travel between your own devices, over your own network, and nowhere else. Basalt runs no server of its own that could receive them.
The only requests that leave your network are the check for updates, and, only if you switch it on, looking up posters for your films and series. Sharing between devices, at home or nearby, never goes through the internet either.
Almost certainly. Basalt plays through mpv, on Windows, Linux and Android alike, so MKV and MP4, HEVC and H.264, 4K and HDR, Dolby Digital Plus and DTS all play, with the subtitle tracks inside the file or a subtitle file anywhere on the drive.
The film you stored is the film you watch. Only when a device cannot play it smoothly, such as 4K on many phones, does the host convert it to 1080p as it plays, and a quality button switches back to the original.
Not to share your files. An ordinary computer is enough, and more viewers cost it almost nothing, because the device you watch on does the playing.
Converting a film for a device that cannot play it takes more, and a graphics chip helps. The host measures how many films it can convert at once, and converting can be switched off in its settings.
Basalt Host keeps itself up to date. It looks for a new version twice a day and installs it when nothing is playing or copying, then your devices reconnect by themselves. You can turn this off under Updates, in Basalt Host or in Manage host. In Docker, you update by pulling the new image.
The apps on your phones and computers show what is new in a version, and update when you say so. Every update is the official release, signed by Basalt’s publisher and checked before it is installed.
Yes. On Windows, Play in your player streams a film straight to VLC, PotPlayer, mpv, MPC and others, starting with the one Windows uses for that kind of file, and Open with lets you pick any player. On Linux, it hands the film to VLC, mpv, Celluloid, Haruna or Videos. On Android, Play in your player hands the film to any player you have, such as VLC. Nothing is copied first.
No. Files stay exactly where they are. The library is an index the host keeps beside them, and hiding a section only tidies the apps’ sidebars.
Recognition works best with names like Arrival (2016) for films and Show/Season 01/S01E01 for episodes, the way most collections are already named.
Not yet. Today Basalt works on your home network: devices find the host on the same network, and nothing is relayed through the internet, so nothing of yours passes through anyone else’s servers.
Yes for Linux and TVs. Basalt runs on Linux desktops as a .deb, an .rpm or an AppImage, and on Android TV and Google TV, made for the remote. On a Fire TV, install the APK.
There is no iPhone, iPad, Apple TV or Mac app yet.
Yes, for phones, tablets and TVs, and Google Play keeps it up to date. The same app is here as an APK too, for devices without Google Play: it keeps itself up to date, showing what is new under More.
The first time you install the APK, Android asks you to allow your browser or file manager to install apps. That permission can be switched off again afterwards.
Every connection is encrypted, and by default a device only joins after someone types the PIN the host shows. Each device signs in with a security key of its own that never leaves it, and remembers the host it paired with, so a different computer pretending to be your host is refused.
Any device can be made read only, or removed, from Basalt Host or from Manage host.
Two steps. Put Basalt Host on the computer with the drive, then Basalt on everything else. Pick the host, type the PIN, and the whole drive is yours, on every screen.
On the computer with the drive. Choose how it runs.
For the computer the drive is in or plugged into. It has a window of its own and waits in the notification area.
The same Basalt Host as on Windows, with the same window, for a Linux computer you sit at.
For a home server, a NAS or a Raspberry Pi. It runs in the background, starts with the computer, and is set up and managed from the Basalt app.
PC for 64-bit Intel and AMD computers, ARM for the Raspberry Pi (64-bit system) and other ARM boards.
sudo apt install ./Basalt-Host-Server-Linux-amd64.deb
For a NAS or a home server that runs containers: Synology, Unraid, TrueNAS, QNAP or your own. Set up and managed from the Basalt app.
docker run -d --name basalt --network host \
-e PUID=1000 -e PGID=1000 \
-v /srv/basalt/config:/config \
-v /srv/media:/media/Media \
--restart unless-stopped ghcr.io/refora-technologies/basalt-host:latest
Change /srv/media to the folder with your files. Then
docker exec basalt basalt-host status shows the setup code.
On every phone, tablet, TV and computer that opens the drive.
Browse the drive, watch the library and move files, with a window of its own.
On Linux: .deb for Ubuntu, Debian and Linux Mint, .rpm for Fedora, AppImage for any other.
One app for phones, tablets and TVs. Laid out for touch on a phone, and for the remote on a TV.
Android 8.0 or later.