Skip to main content

Filesystem operations to index files and hash their contents

Project description

File Ops

File Ops is a set of components and basic CLI to get file statistics from a hard drive. It stores this information in a SQLite database, which you can then query to your heart's content.

With it, you can

  • Store all of the files and directories of a drive with
    • file/directory path
    • file/directory modified at
    • file/directory size
    • file md5 hash

With that information you can (quickly)

  • Find largest files, directories, etc across many external drives.
  • Find duplicate files by comparing hashes
  • Find the largest directories


All commands support a --time flag to output how long it took.

Index File Stats (no hash is calculated for files)

Note: The database file is automatically created if it does not exist and defaults to files.db.

fileops index path/to/index database_file.db  

Hash files in database

fileops hash database_file.db


This removes files that have been deleted, etc. It should be followed by the index command to keep things up to date.

fileops cleanup database_file.db

Calculate Folder Stats

This updates all folders with their sizes. This is a slow process.

fileops folder-stats database_file.db

Find duplicate files by comparing hashes

Use the following query to find the files with the most duplicates

FROM files
WHERE is_directory = 0

Then you can do a query per hash

FROM files
WHERE hash = '94bd41953ca5233c5efe121c73959af7';

Tested on

  • Mac 10.14.3
  • Windows 10
  • Ubuntu 18

Project Goals

  • Minimal dependencies

Feature Ideas

Ignore file settings

  • hidden files
  • certain directories

Command to join database files

I might run multiple copies of the program on several drives, or computers, for speed. When they are all done, I want to merge the output database files into one for easy querying.

Calculate Directory size faster

Right now it works, but its rather slow.

Hash Directories

Given two directories on different hard drives, I would like to be able to quickly know if they have the same contents.

If we hash all the files of a directory, can we hash the individual hashes to get a folder hash? Would that work?

Uniquely Identifier Hard Drives

Given a lot of external hard drives, thumb drives, etc, I want to be able to store them all in a single database file and be able to uniquely identify them.

So if I index a thumb drive on my laptop, I want to be able to take it to my PC and update the index there and still know it's for the same thumbdrive.

If this is implemented, the file paths should not have the mount path. The hard drive identifier should be a separate column.

E.g. on windows


should become


Performance Improvements

Need to see if we can improve the performance. Yep.

Grand Ideas

Supplementary UI application

Doing this from the CLI is great, but it would be nice to have a UI application that could instantly show you

  • Largest Files
  • Largest Duplicate Files
  • Find files by name (see Everything Search -
  • Status Updates as the indexing happens (particularly for hashing)
  • Re-index command
  • Re-calculate hashes command

One source for all files, with sym-links everywhere else

Once you have all of the files indexed for a drive, store them all in a directory and sym-link them everywhere else. With this, remove all duplicates via hash comparison.

This wouldn't work for auto-generated files of course and may only be useful for relatively static directories.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for file-ops, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size file_ops-1.0.4-py3-none-any.whl (30.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size file-ops-1.0.4.tar.gz (13.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page