Storage

Multi-Drive Library

Last updated 3 June 2026

Expand your StreamStash library across multiple local drives while keeping your original library folder as the main location.

Multi-drive mode is for users whose archive is outgrowing a single disk. It lets StreamStash keep the library readable across more than one local drive, while still treating the folder chosen during installation as the main library location.

Optional feature: Multi-drive support is off by default. Nothing changes for existing single-drive installs unless you enable Use multiple drives in Settings.

When To Use Multi-Drive Mode

Use multi-drive mode when you want to keep your current StreamStash library where it is, but add another internal or external local drive for more space.

Move Existing Library Vs Use Multiple Drives

OptionUse it whenWhat happens
Move existing library You want one new storage location. StreamStash moves or rewrites the library to point at a different folder.
Use multiple drives You want to expand storage without relocating everything. The current folder stays as the main drive, and added drives become extra library roots.
Simple rule: Move the library if you want one bigger home. Enable multi-drive mode if you want to keep the current home and add more shelves.

How The Main Drive Is Chosen

The main drive is the recordings folder chosen during installation, or the folder later saved in Settings. This is the folder StreamStash already uses for downloads, recordings, thumbnails, playlists, and app storage decisions.

When you enable multi-drive mode, StreamStash registers that existing location as the main drive first. Added drives do not replace it.

How New Downloads Are Placed

StreamStash fills the main drive first. When the main drive is nearly full, new media can overflow to an added drive with enough free space.

For existing creators, StreamStash tries to keep new files on the same drive where that creator already has a folder, as long as that drive has enough room. This avoids splitting one creator across drives unless space pressure makes it necessary.

Low-space behavior: A drive can stay registered and readable while being skipped for new downloads if it has too little free space. This protects active downloads from landing on a nearly full disk.

How To Enable Multi-Drive Mode

  1. Open Settings in StreamStash.
  2. Go to the storage section.
  3. Turn on Use multiple drives.
  4. Click Add drive and choose a local drive or folder you can write to.
  5. Restart StreamStash when prompted so background workers read the new storage layout.

The added drive will use the same internal library folder layout as the main drive, so media paths remain predictable across platforms.

What Happens If A Drive Is Offline

If an added drive is unplugged or unavailable, StreamStash marks it as offline. The app still remembers the drive and the media stored there, but files on that drive cannot be played, streamed, deduplicated, or deleted until the drive is connected again.

Reconnect the drive and restart StreamStash if the status does not update immediately.

Removing A Drive

Removing an added drive from StreamStash only unregisters it. It does not delete anything from that disk.

Important: If you remove a drive and then delete its files in Windows, StreamStash cannot play that media anymore. The library database may still list the entries, but the files will be missing.

Supported Drive Types

Multi-drive mode is designed for local Windows drives: internal disks, SATA drives, NVMe drives, and attached USB storage that Windows reports as a fixed local drive.

Network paths and cloud-sync folders are not recommended for live library roots. They can be slow, unavailable, placeholder-backed, or subject to sync conflicts while StreamStash is downloading and transcoding files.

Recommended Setup

Troubleshooting

ProblemWhat to check
A drive shows as offline Reconnect the drive, confirm Windows can open it, then restart StreamStash.
New downloads are not using an added drive The main drive may still have enough space, or the added drive may be below the free-space headroom StreamStash needs for safe writes.
Media is listed but will not play The drive holding that file may be offline, renamed outside StreamStash, or manually deleted.
You want everything on one new disk Use Move existing library instead of multi-drive mode.

Related Guides