{"id":27959460,"url":"https://github.com/atomicptr/xdg-termfilechooser-bridge","last_synced_at":"2025-05-07T18:30:12.309Z","repository":{"id":291289083,"uuid":"977106894","full_name":"atomicptr/xdg-termfilechooser-bridge","owner":"atomicptr","description":"The bridge between xdg-desktop-portal-termfilechooser and your favorite terminal based filepicker","archived":false,"fork":false,"pushed_at":"2025-05-03T16:09:59.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-03T17:22:57.858Z","etag":null,"topics":["filepicker","xdg","xdg-desktop-portal"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atomicptr.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-05-03T12:46:35.000Z","updated_at":"2025-05-03T16:10:02.000Z","dependencies_parsed_at":"2025-05-03T17:23:04.414Z","dependency_job_id":"a2dc7176-57f5-4c1d-b254-8bfc636bcc39","html_url":"https://github.com/atomicptr/xdg-termfilechooser-bridge","commit_stats":null,"previous_names":["atomicptr/xdg-termfilechooser-bridge"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomicptr%2Fxdg-termfilechooser-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomicptr%2Fxdg-termfilechooser-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomicptr%2Fxdg-termfilechooser-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomicptr%2Fxdg-termfilechooser-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atomicptr","download_url":"https://codeload.github.com/atomicptr/xdg-termfilechooser-bridge/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252933795,"owners_count":21827585,"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":["filepicker","xdg","xdg-desktop-portal"],"created_at":"2025-05-07T18:30:11.534Z","updated_at":"2025-05-07T18:30:12.249Z","avatar_url":"https://github.com/atomicptr.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xdg-termfilechooser-bridge\n\nThe bridge between [xdg-desktop-portal-termfilechooser](https://github.com/hunkyburrito/xdg-desktop-portal-termfilechooser) and your favorite terminal based filepicker\n\n## Installation\n\n### Install the application\n\n#### via cargo\n\n```bash\n$ cargo install xdg-termfilechooser-bridge\n```\n\n### Setup xdg-desktop-portal-termfilechooser\n\nEdit `$XDG_CONFIG_HOME/xdg-desktop-portal-termfilechooser/config`\n\n```bash\n[filechooser]\ncmd = /path/to/xdg-termfilechooser-bridge\n```\n\n## Configuration\n\nBy default the tool will try to determine your terminal and filepicker automatically by checking if you have one of the\nsupported ones installed, if you want to use a specific one please edit `$XDG_CONFIG_HOME/xdg-termfilechooser-bridge/config.toml`\n\n```toml\nterminal = \"ghostty\"\nfilepicker = \"yazi\"\nstart_at_last_selected_dir = true\n```\n\n## Supported file pickers\n\n- [yazi](https://yazi-rs.github.io/)\n\nIf your favorite terminal filepicker isn't available feel free to [add it yourself](./src/filepicker.rs) or open an issue with the required invoke parameters.\n\n## Supported terminals\n\n- [alacritty](https://alacritty.org/)\n- [foot](https://codeberg.org/dnkl/foot)\n- [ghostty](https://ghostty.org/)\n- [kitty](https://sw.kovidgoyal.net/kitty/)\n- [xterm](https://invisible-island.net/xterm/)\n\nIf your favorite terminal isn't available feel free to [add it yourself](./src/terminals.rs) or open an issue with the required invoke parameters.\n\n## Motivation\n\nThe default script of xdg-desktop-portal-termfilechooser has had several issues in the past and beyond these I wanted to customize\nthe behaviour of it further so I wrote a tool to do so.\n\n## License\n\nGPLv3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomicptr%2Fxdg-termfilechooser-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatomicptr%2Fxdg-termfilechooser-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomicptr%2Fxdg-termfilechooser-bridge/lists"}