{"id":23989599,"url":"https://github.com/candidtim/f2-commander","last_synced_at":"2025-06-24T20:07:15.340Z","repository":{"id":253643133,"uuid":"843132717","full_name":"candidtim/f2-commander","owner":"candidtim","description":"F2 Commander is an orthodox file manager for the modern world","archived":false,"fork":false,"pushed_at":"2025-05-26T22:33:10.000Z","size":3986,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-18T01:41:29.571Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://candidtim.github.io/f2-commander/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/candidtim.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":"2024-08-15T21:13:31.000Z","updated_at":"2025-05-22T21:53:21.000Z","dependencies_parsed_at":"2024-08-18T13:13:52.198Z","dependency_job_id":"8bb32dd2-da64-438d-b01f-501d4812d67d","html_url":"https://github.com/candidtim/f2-commander","commit_stats":null,"previous_names":["candidtim/f2-commander"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/candidtim/f2-commander","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Ff2-commander","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Ff2-commander/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Ff2-commander/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Ff2-commander/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/candidtim","download_url":"https://codeload.github.com/candidtim/f2-commander/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Ff2-commander/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261749186,"owners_count":23203990,"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","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-01-07T17:32:16.343Z","updated_at":"2025-06-24T20:07:15.299Z","avatar_url":"https://github.com/candidtim.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# F2 Commander\n\nF2 Commander is an orthodox file manager for the modern world.\n\n![F2 Commander Showcase](docs/img/f2.png \"F2 Commander Showcase\")\n\n## Installation\n\nFrom PyPI:\n\n    pipx install f2-commander\n\nor:\n\n    uvx --from f2-commander f2\n\nFrom source:\n\n    uv build\n    pipx install [--force] dist/f2_commander-0.5.1.tar.gz\n\nThis software is designed to work in Linux and macOS. It should also work in\nWSL (Windows Subsystem for Linux).\n\n## Usage\n\n - Start by running `f2` in your terminal emulator\n - Hit `?` to see the built-in help\n - Hit `q` to quit\n\n## About\n\nF2 Commander exists to bring the experience of an orthodox file manager into\nthe world of modern computing.\n\nA \"file system\" can be anything that can seem to contain files and directories,\n(a local disk, a BLOB storage, a Cloud drive, a compressed file, etc.).\n\nFinally, it is designed to be discoverable: making file systems easy to\nnavigate, and making the F2 Commander itself obvious to use.\n\nF2 Commander is an overgrown personal project, may contain bugs, and is\nprovided \"as is\", without warranty of any kind.\n\n## Features\n\nBelow is a short summary. For a complete list of features, existing and\nplanned, see the [complete feature list](docs/features.md). Some features are a\nwork-in-progress as indicated below.\n\n - [x] Works in Linux, macOS\n - [ ] Works in WSL (should work, but to be extensively tested)\n - [x] An orthodox two-panel interface with a footer menu\n - [x] Vi-like key bindings\n - [ ] Classic Fn key bindings, and configurable key bindings\n - [x] Command Palette (Ctrl-P)\n - [x] Rich and flexible file listing (file attributes, ordering options,\n       filtering with glob, hidden files toggle, compute directory size,\n       and more)\n - [x] Incremental search (type to search, fuzzy matching)\n - [ ] Recursive file search. Find in (text) files.\n - [x] Integration with native OS applications (open a directory in a file\n       manager, open a file with a default program)\n - [x] File and directory manipulation (copy, move, move to trash,\n   etc.)\n - [x] Multiple file selection\n - [x] View and edit files\n - [x] Configurable bookmarks. Quick \"Go to path\".\n - [x] Preview panel\n - [x] Drop to shell\n - [x] User-level configuration file\n - [x] Extensive \"Remote File systems\" support. A non-exhaustive list\n       includes: AWS S3, GCP GCS, Azure ADLS, OCI, OSS, DVC, LakeFS, HDFS,\n       Dropbox, Google Drive, FTP/FTPS, SFTP, SMB, WebDAV, and many more.\n       Custom implementations are possible through other\n       [fsspec](https://github.com/fsspec/filesystem_spec) implementations and\n       plugins. \\*\\*See also the note below.\n - [x] Read and write archives and compressed files. A non-exhaustive\n       list includes: ZIP, TAR, XAR, LHA/LZH, ISO 0660 (optical disc files),\n       cpio, mtree, shar, ar, pax, RAR, MS CAB, 7-Zip, WARC, and more -\n       everything supported by [libarchive](https://github.com/libarchive/libarchive).\n - [x] Multiple color themes\n - [x] Built-in help\n\n\u003e \\*\\*Note: Remote file systems are in *preview*. All features are available,\n\u003e but not extensively tested. Connection dialog is rather crude, but is\n\u003e otherwise functional. Connections can be preconfigured in a configuration\n\u003e file using raw `fsspec` key-value format (see built-in help for more deatils).\n\nAnd, hopefully, a polished up user experience that you'd normally expect from\na robust file manager. Feel free to submit any issues to make F2 Commander\neven better!\n\nSee also a [list of known bugs](docs/testing.md).\n\n## Development environment\n\nThis project uses [uv](https://docs.astral.sh/uv/). The configuration is\nconventional, use as usual:\n\n    uv run f2\n\nStatic code analysis and type checks (ruff, mypy) can be ran with `uvx`. For\nexample:\n\n    uvx run ruff check\n    uvx run mypy\n\nTests use pytest, installed with the dev dependencies:\n\n    uv run pytest\n\nTo run all code quality controls:\n\n    ./check\n\nTo run the application with dev tools:\n\n    uv run textual console [-v -x SYSTEM -x EVENT -x DEBUG -x INFO]  # this first!\n    uv run textual run --dev f2.app:F2Commander\n\nTo run tests in all target Python versions (typically before a release):\n\n    uvx nox [-r]  # -r == --reuse-existing-virtualenvs\n\n## About (continued)\n\n\"F2\" is a loose interpretation of \"a **F**ile manager with **2** side-by-side\npanels\", and \"Commander\" is an homage to the old-school orthodox file managers.\n\n\"F2 Commander\" is a personal project that has grown into a full-fledged file\nmanager and is now open-sourced. Being a personal project means that:\na) my intent is to continue the development of the features outlined above, but\n   the development and bug fixing may be irregularly-paced and priorities may\n   shift;\nb) my intent is to keep F2 Commander stable, but future versions may include\n   backward-incompatible changes where that would seem pragmatic.\n\n## Special Thanks\n\nF2 Commander is made with [Textual](https://github.com/textualize/textual/)\nframework, [fsspec](https://github.com/fsspec/filesystem_spec) and other great\npackages. Many features are made possible or stem directly from these, and I\nencourage F2 Commander users to support them.\n\n## Contributions\n\nBug reports, feature requests and pull requests are welcome.\n\nIf you plan to contribute to the source code, see the \"Development environment\"\nabove and, please, note that:\n\n - contributed source code must pass the `./check`,\n - in this repository, contributed source code is only accepted under Mozilla\n   Public License 2.0 and should include according file headers.\n\n## License\n\nThis application is provided \"as is\", without warranty of any kind.\n\nMozilla Public License, v. 2.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcandidtim%2Ff2-commander","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcandidtim%2Ff2-commander","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcandidtim%2Ff2-commander/lists"}