{"id":30612700,"url":"https://github.com/picobaz/bashdirblaster","last_synced_at":"2025-09-02T14:04:40.842Z","repository":{"id":311889470,"uuid":"1045465871","full_name":"PicoBaz/BashDirBlaster","owner":"PicoBaz","description":"BashDirBlaster: A stealthy Bash scanner for Linux file systems. Hunt files, filter by type, and log in JSON/CSV. Explore with precision—authorized missions only!","archived":false,"fork":false,"pushed_at":"2025-08-27T11:02:27.000Z","size":20,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-27T17:11:07.285Z","etag":null,"topics":["bash","csv-output","devops-tools","directory-hunter","file-analysis","file-explorer","interactive","linux","system-scanner"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PicoBaz.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-08-27T08:06:10.000Z","updated_at":"2025-08-27T11:19:00.000Z","dependencies_parsed_at":"2025-08-27T17:11:29.057Z","dependency_job_id":"9fed34a4-4b30-45a1-89bf-31977a5e4b5e","html_url":"https://github.com/PicoBaz/BashDirBlaster","commit_stats":null,"previous_names":["picobaz/bashdirblaster"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/PicoBaz/BashDirBlaster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PicoBaz%2FBashDirBlaster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PicoBaz%2FBashDirBlaster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PicoBaz%2FBashDirBlaster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PicoBaz%2FBashDirBlaster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PicoBaz","download_url":"https://codeload.github.com/PicoBaz/BashDirBlaster/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PicoBaz%2FBashDirBlaster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272808960,"owners_count":24996605,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"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":["bash","csv-output","devops-tools","directory-hunter","file-analysis","file-explorer","interactive","linux","system-scanner"],"created_at":"2025-08-30T05:35:25.709Z","updated_at":"2025-08-30T05:35:28.178Z","avatar_url":"https://github.com/PicoBaz.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n        _____\n       /     \\\n      /_______\\\n      |  ***  |  BashDirBlaster\n      |  ***  |  Unleash the File System Explorer\n      |_______|\n   ```\n## Mission Brief\nWelcome, Pathfinder! *BashDirBlaster* is your trusty Linux tool for navigating the wild jungles of file systems. Built for speed and stealth, this Bash script scans directories recursively, hunts for files by extension, and logs your findings in JSON and CSV. Whether you're auditing codebases, tracking down configs, or mapping project structures, this tool is your map to buried treasure.\n\n\u003e **Warning**: Only explore territories you have clearance for. Unauthorized scans are a no-go.\n## Features\n- Recursive directory scanning with depth control.\n- File filtering by extension.\n- Advanced filters for size and age.\n- Content search in files.\n- Cleanup of temporary files.\n- Interactive CLI menu for module selection.\n- JSON and CSV output with error handling.\n\n## Gear Up\n- **Recursive Probes**: Dive deep into directories with configurable depth limits.\n- **File Filters**: Target specific file types (e.g., `.sh`, `.txt`) like a laser.\n- **Mission Logs**: Export results to JSON and CSV for easy analysis.\n- **Control Panel**: Tweak settings in `config.json` for precision scans.\n- **Resilience**: Auto-retries on errors to keep your mission on track.\n- **Linux-Optimized**: Harnesses `find` and `jq` for blazing-fast performance.\n\n## Launch Protocol\n1. **Secure the Base**:\n   ```bash\n   git clone https://github.com/PicoBaz/BashDirBlaster.git\n   cd BashDirBlaster\n2. **Equip Dependencies**:\n   Install `jq` for JSON processing:\n   ```bash\n   sudo apt install jq  # Ubuntu/Debian\n   sudo dnf install jq  # Fedora\n   ```\n3. **Calibrate Scanner**:\n   Edit `config.json` to set your target directory, extensions, and scan parameters.\n\n4. **Initiate Scan**:\n   ```bash\n   bash dir_scanner.sh\n   ```\n    - **Output**: Check `scan_results.json` and `scan_results.csv` for your loot.\n    - **Sample Config**:\n      ```json\n      {\n        \"directory\": \"./src\",\n        \"extensions\": [\".sh\"],\n        \"maxDepth\": 5,\n        \"retryCount\": 3,\n        \"retryDelayMs\": 1000\n      }\n      ```\n\n## Control Panel Settings\nTune your scanner in `config.json`:\n- `directory`: Starting point (e.g., `./` for current folder).\n- `extensions`: File types to hunt (e.g., `[\".sh\", \".txt\"]`). Empty = all files.\n- `maxDepth`: How deep to venture (e.g., `5`).\n- `retryCount`: Retry attempts for blocked paths.\n- `retryDelayMs`: Pause between retries (in milliseconds).\n\n## Mission Log Example\n```csv\nName,Path,Type,Extension,Size (Bytes),Timestamp,Error\n\"script.sh\",\"./src/script.sh\",\"file\",\".sh\",1024,2025-08-27T11:56:00Z,\n\"utils\",\"./src/utils\",\"directory\",\"\",0,2025-08-27T11:56:00Z,\n```\n\n## Upgrade Your Gear\n- **Custom Filters**: Add size or date-based filters in `dir_scanner.sh`.\n- **Integrations**: Pair with `grep` or `awk` for advanced analysis.\n- **Parallel Scans**: Use `parallel` for massive directories (fork and enhance!).\n\n## Code of Conduct\nThis tool is for authorized missions only. Scan only what you own or have permission for. Misuse is not our style.\n\n## License\nMIT License. Check [LICENSE](LICENSE) for the fine print.\n\n## Join the Expedition\nFound a bug? Got a wild idea? Open an issue or PR at https://github.com/PicoBaz/BashDirBlaster.  \nDrop a ⭐ if *BashDirBlaster* lights up your file system!\n\n---\n*Crafted by PicoBaz, 2025*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpicobaz%2Fbashdirblaster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpicobaz%2Fbashdirblaster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpicobaz%2Fbashdirblaster/lists"}