Particles

Local, offline web application to scan a folder, index files, filter, sort, paginate, add tags, preview multiple formats, open files with the default software, and move files.

Features

• Recursive scan of a root folder
• Text search on name, path, and tags
• Backend/frontend pagination with batch loading
• Sorting by name, date, type, and tags
• Add and remove tags
• Cross-platform file or parent folder opening
• Move files via buttons or drag-and-drop to a target folder
• Built-in preview for PDF, images, audio, video, and text
• Office file preview via LibreOffice conversion if available
• Local metadata storage in data/metadata.json

Quick Start

python launch.py

The script:

• Automatically uses the Python from the .venv folder
• Checks that Flask is installed
• Starts the local server
• Opens the browser at http://127.0.0.1:5000

Manual Setup

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python app.py

Then open http://127.0.0.1:5000.

Notes

• The default root folder is the project directory. You can change it in the interface and then rescan.
• Project technical directories (data, static, templates, .git, venv, .venv) are ignored during indexing.
• File opening is supported on Windows, macOS, and Linux.
• Subfolder scanning is disabled by default. You can enable it and limit its depth from the interface.
• For DOCX/ODT/XLSX/PPTX previews, install LibreOffice if you want automatic conversion to PDF.