{"id":39510333,"url":"https://github.com/vg-dev1/fdir","last_synced_at":"2026-01-25T22:44:09.528Z","repository":{"id":329579939,"uuid":"1120059563","full_name":"VG-dev1/fdir","owner":"VG-dev1","description":"Find and organize anything on your system","archived":false,"fork":false,"pushed_at":"2026-01-17T17:12:21.000Z","size":211,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T03:34:06.140Z","etag":null,"topics":["cli","command-line","filesystem","python","search","terminal","tool"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VG-dev1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-20T12:01:23.000Z","updated_at":"2026-01-17T16:44:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/VG-dev1/fdir","commit_stats":null,"previous_names":["vg-dev1/fdir"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/VG-dev1/fdir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VG-dev1%2Ffdir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VG-dev1%2Ffdir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VG-dev1%2Ffdir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VG-dev1%2Ffdir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VG-dev1","download_url":"https://codeload.github.com/VG-dev1/fdir/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VG-dev1%2Ffdir/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28531991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","filesystem","python","search","terminal","tool"],"created_at":"2026-01-18T06:01:35.397Z","updated_at":"2026-01-25T22:44:09.521Z","avatar_url":"https://github.com/VG-dev1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fdir\n\n![PyPI - Downloads](https://img.shields.io/pypi/dm/fdir-cli)\n[![Latest Release](https://img.shields.io/github/v/release/VG-dev1/fdir)](https://github.com/VG-dev1/fdir/releases)\n![GitHub Repo stars](https://img.shields.io/github/stars/VG-dev1/fdir)\n[![GitHub License](https://img.shields.io/github/license/VG-dev1/fdir)](https://github.com/VG-dev1/fdir/blob/main/LICENSE.md)\n\n`fdir` is a program for finding and organizing anything on your system. It is a simple and user-friendly way to find the files that you need and do something with them.\n\n[Installation](#installation) • [Usage](#usage)\n\n![Demo](https://i.ibb.co/pmXCwZT/demo2.png)\n\n## Features\n\n- Intuitive syntax: Use operations like `size` or `modified` instead of complex flags.\n- Logical operators: Combine searches with `and` or `or`.\n- Deep search: Traverse directories recursively.\n- Batch processing: Convert file types or delete results directly from the search.\n- Visual feedback: Heatmap coloring for file sizes and highlighting for matched patterns.\n- Smart navigation: Includes hyperlinks to open matching files directly from the terminal.\n\n## Usage\n\nYou can get a list of all the commands by running `fdir --help`.\n\n### Searching by name\n\nfdir provides specific flags to match filenames. You can search for a keyword anywhere in the name, or specify if the name starts or ends with a pattern:\n\n```bash\nfdir name --keyword report\nfdir name --swith 2023_\n```\n\nAdditionally, you can enable fuzzy (typo-tolerant) search using the `--fuzzy` flag:\n\n```bash\nfdir name --keyword reprot --fuzzy\n```\n\n### Searching for a particular file extension\n\nUse the `type` operation to find files with a specific extension (including the dot):\n\n```bash\nfdir type --eq .py\n```\n\n### Filtering by modification time\n\nYou can filter files based on how long ago they were modified using units like `h` (hours), `d` (days), `w` (weeks), `m` (months), and `y` (years):\n\n```bash\nfdir modified --lt 1w\n```\n\n### Searching by keywords inside files\n\nYou can even look inside files for keywords using the `content` operation:\n\n```bash\nfdir content --keyword main\n```\n\n\u003e [!NOTE]\n\u003e Only supported for textual files.\n\n### Searching for hidden files\n\nfdir doesn't show hidden files by default. To show them, add the `--hidden` flag.\n\n\u003e [!NOTE]\n\u003e This only shows files that weren't hidden using a `.fdirignore` file.\n\n### Logical operators\n\nUnlike many search tools, fdir allows you to combine two different operations using `and` or `or`:\n\n```bash\nfdir modified --gt 1y or size --gt 1gb\n```\n\n### Command execution\n\nInstead of just listing files, you can execute another command for every result found using the `--exec` flag:\n\n```bash\nfdir type --eq .jpg --exec echo Hi! '{}'\n```\n\n### File deletion\n\nYou can delete all the matching files using the `--del` flag:\n\n```bash\nfdir size --gt 1gb --del\n```\n\n### File conversion\n\nThe type operation allows you to rename and convert the extensions of all matching files using the `--convert` flag:\n\n```bash\nfdir type --eq .wav --convert .mp3\n```\n\n### Customizing output\n\n#### Print order\n\nYou can sort the matching files using the `--order` flag:\n\n```bash\nfdir modified --gt 1y --order modified a\n```\n\n#### Column order\n\nYou can reorder the output columns using the `--columns` flag with `n` (name), `d` (date), and `s` (size):\n\n```bash\nfdir all --columns nsd\n```\n\n#### No color output\n\nIf you don't want the colored output enabled by default, you can use the `--nocolor` flag:\n\n```bash\nfdir all --nocolor\n```\n\n### Excluding files\n\nYou can create a `.fdirignore` file in the directory you're running `fdir` from to exclude certain file names, directories, or extensions. They're like `.gitignore` files, but used by `fdir`.\n\n### Recursive search\n\nBy default, `fdir` doesn't search recursively. To enable that, you can use the `--deep` flag:\n\n```bash\nfdir all --deep\n```\n\n## Options\n\nHere are all `fdir`'s options (this is the output of `fdir --help`):\n\n```\nusage: fdir [-h] [--deep] [--top NUMBER] [--fuzzy] [--case] [--order FIELD DIR] [--columns COLUMNS] [--del]\n            [--convert EXTENSION] [--nocolor] [--exec ...] [--hidden]\n            {modified,size,name,type,content,all,version} ...\n\npositional arguments:\n  {modified,size,name,type,content,all,version}\n    modified            Filter by date\n    size                Filter by size\n    name                Filter by name\n    type                Filter by extension\n    content             Search inside file content\n    all                 List all files\n    version             Show version\n\noptions:\n  -h, --help            show this help message and exit\n  --deep                Search recursively\n  --top NUMBER          Show only first N results\n  --fuzzy               Search approximately\n  --case                Case-sensitive search\n  --order FIELD DIR     Sort: \u003cname|size|modified\u003e \u003ca|d\u003e\n  --columns COLUMNS     Column order (e.g., nds)\n  --del                 Delete matches\n  --convert EXTENSION   Convert to new extension\n  --nocolor             Disable colors\n  --exec ...            Execute command (use {} for path)\n  --hidden              Show hidden files in search\n```\n\n## Installation\n\n### pip\n\n```bash\npip install fdir-cli\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvg-dev1%2Ffdir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvg-dev1%2Ffdir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvg-dev1%2Ffdir/lists"}