linux-storage-sense
linux-storage-sense copied to clipboard
Keep your Linux storage clean and organized effortlessly.
![](https://github.com/omegaui/linux-storage-sense/raw/main/images/icon.png)
written with ♥️ in V lang
Linux Storage Sense
Linux Storage Sense is a lightweight and efficient command line program designed for Linux operating systems. Its main function is to help users manage their storage space by automatically deleting files at specified paths after a specified period of time.
Features
- Auto Deletes files at specified paths after a specified period of time
- Lightweight and efficient, with minimal CPU and memory usage
- Highly customizable, with options to specify paths and time periods (even weeks, months and years are supported)
Resource Usage
Linux Storage Sense is designed to use minimal CPU and memory resources. The program is written using efficient algorithms and data structures, minimizing the use of system calls and disk I/O, and optimizing the code for the Linux operating system. This allows it to run in the background without impacting other processes or causing slowdowns on the system.
Finely tested on Ubuntu 22.10
Architecture
The program has two parts.
- Storage Sense Configurator: Used for adding and remove watchdogs.
- Storage Sense Daemon: Auto starts on system login and cleans storage according to the configurations provided.
To use Linux Storage Sense, users must specify the paths of the files they want to manage and the period of time after which they want these files to be deleted. Then, the daemon process will automatically identify and delete the appropriate files.
Example
Listing Active Watchdogs
$ storage-sense-config
Adding Files/Directories
$ storage-sense-config --add="temp.txt:images"
Removing Files/Directories
$ storage-sense-config --remove="temp.txt:images"
the add flag, further asks for the time period and time unit, here's an example run:
omegaui@asus:~$ storage-sense-config --add="/home/omegaui/VS Code Projects/linux-storage-sense/update-config.sh"
Validating Paths ...
- /home/omegaui/VS Code Projects/linux-storage-sense/update-config.sh ✔️
1 valid path(s), 0 invalid path(s)
time period can be in seconds, minutes, days, weeks, months or even years
example: 12 seconds, 20 days, etc
Enter time period: 190 seconds
Adding NEW Watchdog: /home/omegaui/VS Code Projects/linux-storage-sense/update-config.sh
---> Saving Configuration [0 ms]
---> Adding Watchdogs [7642 ms]
Usability
General Purpose
Linux Storage Sense is an ideal choice for users who want to automate file cleanup tasks on their Linux systems without causing performance issues or slowing down other processes. Its lightweight and efficient design, along with its customizability, make it a valuable tool for managing storage space on Linux systems.
Development Purpose
Programmers who want to delete raw files generated by their program over time, during testing or debugging, can use storage-sense to automate the task as it also supports seconds as time unit.
Install
Linux One Liner Install Command
curl https://raw.githubusercontent.com/omegaui/linux-storage-sense/main/installer.sh | sh
installer.sh
#!/bin/bash
echo "* The Installer requires administration access"
echo "Setting up default session config ..."
cd ~/.config
mkdir storage-sense
cd storage-sense
wget https://raw.githubusercontent.com/omegaui/linux-storage-sense/main/bin/storage-sense-config.json
echo "Setting up autostart ..."
cd ~/.config/autostart
wget https://raw.githubusercontent.com/omegaui/linux-storage-sense/main/bin/linux-storage-sense.desktop
echo "Downloading Storage Sense Configurator ..."
sudo wget https://raw.githubusercontent.com/omegaui/linux-storage-sense/main/bin/storage-sense-config --output-document=/usr/bin/storage-sense-config
echo "Stopping Daemon (if running) ..."
pkill -f storage-sense-daemon
echo "Downloading Storage Sense Daemon ..."
sudo wget https://raw.githubusercontent.com/omegaui/linux-storage-sense/main/bin/storage-sense-daemon --output-document=/usr/bin/storage-sense-daemon
sudo chmod 0755 /usr/bin/storage-sense-config
sudo chmod 0755 /usr/bin/storage-sense-daemon
echo "All Set!"
echo "Add some files with storage-sense-config command and then,"
echo "a system restart is required initially for the daemon to start!"
The Installer downloads the latest configurator and daemon binaries from the repo to /usr/bin
and makes them
executable with chmod, and it also configures the daemon to autostart when you log in, moreover, it also configures
the default session by creating the storage-sense
directory in ~/.config
and downloading the session-config.json
.