Skip to content


Repository files navigation

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.


  • 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


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.


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/"
Validating Paths ...
- /home/omegaui/VS Code Projects/linux-storage-sense/ ✔️
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/
 ---> Saving Configuration [0 ms]
 ---> Adding Watchdogs [7642 ms]


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.


Linux One Liner Install Command

curl | sh


echo "* The Installer requires administration access"

echo "Setting up default session config ..."
cd ~/.config
mkdir storage-sense
cd storage-sense

echo "Setting up autostart ..."
cd ~/.config/autostart

echo "Downloading Storage Sense Configurator ..."
sudo wget --output-document=/usr/bin/storage-sense-config

echo "Stopping Daemon (if running) ..."
pkill -f storage-sense-daemon

echo "Downloading Storage Sense Daemon ..."
sudo wget --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.

NOTE: Time calculations are based on the system uptime and not the realtime date