{"id":34837444,"url":"https://github.com/workdone0/fos","last_synced_at":"2026-05-16T16:02:31.620Z","repository":{"id":255510808,"uuid":"850683350","full_name":"workdone0/fos","owner":"workdone0","description":"fos (Find On Steroids) is a powerful command-line tool written in Python. It allows you to search and view files within a folder effortlessly.","archived":false,"fork":false,"pushed_at":"2024-09-05T17:16:02.000Z","size":447,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-09-06T22:30:26.294Z","etag":null,"topics":[],"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/workdone0.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}},"created_at":"2024-09-01T13:42:34.000Z","updated_at":"2024-09-05T17:16:02.000Z","dependencies_parsed_at":"2024-09-05T22:00:02.986Z","dependency_job_id":null,"html_url":"https://github.com/workdone0/fos","commit_stats":null,"previous_names":["workdone0/fos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/workdone0/fos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workdone0%2Ffos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workdone0%2Ffos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workdone0%2Ffos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workdone0%2Ffos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/workdone0","download_url":"https://codeload.github.com/workdone0/fos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workdone0%2Ffos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28032428,"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-12-25T02:00:05.988Z","response_time":58,"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":[],"created_at":"2025-12-25T16:10:00.729Z","updated_at":"2025-12-25T16:11:05.835Z","avatar_url":"https://github.com/workdone0.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\" style=\"margin: 20px\"\u003e\n\t\u003cimg height=\"150px\" width=\"150px\" src=\"images/logo.png\"\u003e\n\u003c/div\u003e\n\n# fos (Find On Steroids)\n\n**fos** (Find On Steroids) is a powerful command-line tool written in Python using the [Textual](https://github.com/Textualize/textual) library. It allows you to search and view files within a folder effortlessly. Inspired by the [Frogmouth](https://github.com/Textualize/frogmouth) project, **fos** takes file browsing to the next level by combining search functionality with a user-friendly interface for file exploration.\n\n## Screenshots\n![Directory Tree](images/dir_tree.png)\n![Syntax Highlighting](images/syntax_highlight.png)\n## Features\n\n- **Search and Browse Files:** Seamlessly search for files and browse through them within a specified folder.\n- **Syntax Highlighting:** View file contents with syntax highlighting, making it easier to read and understand code files.\n- **SidePanel Navigation:** A side panel with a DirectoryTree widget allows for easy navigation through your folder structure.\n\n## Installation\n\nTo get started with **fos**, clone the repository and install the required dependencies:\n\n```bash\ngit clone https://github.com/yourusername/fos.git\ncd fos\npip install -r requirements.txt\n```\n\n## Usage\n\nRun **fos** by navigating to the directory where it's installed and using the following command:\n\n```bash\npython fos/app.py --path=/path/to/your/folder\n```\n\nReplace `/path/to/your/folder` with the path of the folder you wish to browse and search within. Skip the `--path` parameter if you want to view the current folder.\n\n### Command-Line Options\n\n- `--path`: Path to the folder you want to browse.\n- `--help`: Show help message with usage details.\n\n## Contribution\n\n**fos** is still in active development, and we welcome contributions from the community! Some areas that need improvement include:\n\n- **Multiple Themes:** We currently lack support for multiple themes, and contributions to add this feature are highly appreciated.\n- **Image Viewing:** Support for viewing images is not yet implemented, so feel free to work on this feature.\n- **Optimizations:** Any other improvements, optimizations, or feature requests are welcome.\n\nTo contribute, follow these steps:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature-branch`).\n3. Make your changes and commit them (`git commit -m 'Add some feature'`).\n4. Push to the branch (`git push origin feature-branch`).\n5. Open a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgements\n\n- [Textual](https://github.com/Textualize/textual) library by [Textualize](https://github.com/Textualize) for making it easier to build rich TUI applications in Python.\n- [Frogmouth](https://github.com/Textualize/frogmouth) project for the inspiration.\n\n---\n\nFeel free to reach out with any questions or suggestions!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkdone0%2Ffos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fworkdone0%2Ffos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkdone0%2Ffos/lists"}