spacedrive/docs/product/guides/locations.mdx
Jamie Pine 0ccc038900
More important docs! (#2317)
* docs

* docs

* doc

* revert

* revert

* move actions to arch

* docs

* docssss

* typo

* duplicate

* fix date

* x

* jobs

* jobs

* Update jobs.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update jobs.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update libraries.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update spaces.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update spaces.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update spaces.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update introduction.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update clouds.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update clouds.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update clouds.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update importing-photos.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update interface.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update jobs.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update library-setup.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update locations.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update quick-preview.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* Update quick-preview.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* changes

* stuff

* fix

* rag stuff wip

* Update docs/product/guides/importing-photos.mdx

Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>

* del

* fixed typos/changed wording for some docs

---------

Co-authored-by: Utku <74243531+utkubakir@users.noreply.github.com>
Co-authored-by: 0xBA5E64 <26796481+0xBA5E64@users.noreply.github.com>
Co-authored-by: myung03 <matthewyungisworking@gmail.com>
2024-05-15 00:47:00 +00:00

68 lines
3 KiB
Plaintext

---
index: 4
---
# Locations
Locations are places Spacedrive looks for files. You can add Locations from any device to your Library and they will be scanned and monitored for filesystem changes.
![Spacedrive Locations from the Settings view](/locations.webp)
Locations can be managed from the settings. The "connected" indicator shows if that Location is currently accessible from one of your devices.
Spacedrive allows you to browse your local filesystem before creating a Location via the [Local Explorer](/docs/product/guides/interface#Local%20Explorer), but it may take longer to load Explorer data without the indexing process of Locations. You can convert any local path to a Location when browsing your local filesystem from the top bar or the context menu.
## Scanning
When a Location is added it is immediately scanned. The scan happens in several phases as [Jobs](/docs/product/guides/jobs).
1. The [Indexer](): directory structure is indexed and saved to your library's database.
2. The [Identifier](): metadata is extracted and unique identifiers generated.
3. The [Thumbnailer](): compressed previews are generated for all media and text files.
If any one of these jobs fail or the application is closed, the state is saved and it will resume when the app is relaunched.
<Notice
type="info"
text="If you wish to pause or cancel these jobs you can do so from the [Job Manager](/docs/product/guides/jobs#Job%20Manager)"
/>
There is a button to trigger a full re-scan of this Location. Otherwise, the location will keep watch for filesystem changes automatically.
Deleting a location will remove the data from the database permanently. If you wish to keep the data but not have it in your library, you can [archive](#Archiving) the location.
## Archiving
<Notice
type="note"
title="WIP"
text="This feature is not available yet, please check our [roadmap](/roadmap)."
/>
Locations can be archived, meaning the directory structure is extracted from the Spacedrive database
and preserved as a standalone database file. This file can be opened by Spacedrive in the [Database]()
view.
Archives are useful when files have been moved or deleted from a Location, but you want to keep a record of the directory structure of that Location without cluttering the Spacedrive interface. File metadata can optionally be included/excluded from the archive file.
## Dynamic Space
<Notice
type="note"
title="WIP"
text="This feature is not available yet, please check our [roadmap](/roadmap)."
/>
A slider in the Location settings allows you to allocate an amount of GB to use as redundancy for other Locations. The storage space will be filled and emptied dynamically, with priority given to recent and important files being copied.
## Size Limit
<Notice
type="note"
title="WIP"
text="This feature is not available yet, please check our [roadmap](/roadmap)."
/>
A Location can be set to have a size limit, which will prevent the Location from growing beyond the set
limit. Files will be removed from the Location based on the last accessed time, with oldest files being
removed first.