Software Documentation
Managing Your Library
The Browse tab gives you an overview of all the documents in your database. You can view your files, filter by name, open the originals, delete documents you no longer need, and check the health of your database.
Viewing Your Documents
Click List/Refresh Files in Database to load your document list. Each document shows:
| Column | What it shows |
|---|---|
| Filename | The name of the uploaded file |
| File Type | The format (PDF, DOCX, TXT, etc.) |
| File Sets | Which groups the document belongs to |
| Chunks | How many passages were created from this document |
| Date Added | When the document was uploaded |
| File Size | The size of the original file |
Filtering
Use the Quick Filter text box to narrow the list by filename. This searches as you type — useful when you have many documents and need to find a specific one. The filter shows how many documents match (e.g., "Showing 3 of 47").
Working with Files
Select one or more documents using the checkboxes, then use the buttons in the File Operations area:
- Open Selected File — Opens the original source file in its default application (e.g., opens a PDF in your PDF reader). Works with one file at a time.
- Open Docs Folder — Opens the folder where Archivist stores copies of your uploaded source files, in case you want to browse them directly.
Selecting Multiple Files
Use the Select All Files button to select every visible document (respects your current filter). Clear Selections deselects everything.
Deleting Documents
- Select the documents you want to remove.
- Click Delete Selected Files.
- A confirmation dialog will appear showing exactly what will be removed — the documents themselves, all their associated passages and search data.
Warning
Deletion is permanent and cannot be undone. If you might need the documents again, consider keeping them and simply removing them from specific file sets instead (via the Inspect tab).
Database Health Check
The Database Health Report button runs a diagnostic scan of your database, checking for:
- Orphaned files — Source files on disk that aren't referenced in the database
- Missing files — Database entries that point to files that no longer exist on disk
- Hash mismatches — Files that have been modified since they were uploaded
If issues are found, the health report will explain what they are and offer a cleanup option to fix them automatically.
This is useful if something seems off — for example, if a document isn't appearing when you search, or if you've manually moved files around outside of Archivist.
Next Steps
- Inspect individual passages to review content and manage tags
- Ask questions about your documents