cd ~/.filedot filedot extensions enable showstars The system will prompt you with dependency checks. Type Y to proceed. Once enabled, you need to activate the visual layer. Edit the main configuration file:
sudo chown -R $USER:$USER ~/.filedot Cause: Another instance of FileDot is running in the background. filedot showstars install
git clone https://github.com/filedot-ecosystem/showstars.git ~/.filedot/extensions/showstars Navigate to your FileDot configuration directory: Edit the main configuration file: sudo chown -R
[ui] theme = showstars show_ratings = true rating_persistence = sqlite Save the file (Ctrl+O, then Ctrl+X in nano; or just save in your default editor). ShowStars requires a local database to store ratings. Run: Run: filedot showstars init You will see: Initialized
filedot showstars init You will see: Initialized rating database at ~/.local/share/filedot/ratings.db Close any open FileDot instances and restart:
| Requirement | Minimum Spec | Recommended | |-------------|--------------|--------------| | | Windows 10 / Ubuntu 20.04 | Windows 11 / Ubuntu 22.04 LTS | | FileDot Core | Version 3.2+ | Version 4.0+ | | RAM | 4 GB | 8 GB | | Storage | 200 MB for plugin | 500 MB (for cache) | | Permissions | Read/Write access to config directory | sudo/Admin rights | | Dependencies | Python 3.8+ or Node.js 16+ (varies by build) | Both |
ShowStars requires that FileDot was originally installed with metadata journaling enabled. If you used the --minimal flag during the initial FileDot setup, you must reinstall the core first. Step-by-Step: FileDot ShowStars Install Below is the canonical method for installing ShowStars on a standard FileDot instance. We cover three major platforms: Windows (PowerShell), macOS (Terminal), and Linux (Bash). Step 1: Verify Your Existing FileDot Installation Open your terminal or command prompt and run: