{"id":7785764,"url":"https://github.com/yohasebe/finder-unclutter","last_synced_at":"2025-04-14T13:02:55.673Z","repository":{"id":221766253,"uuid":"755325447","full_name":"yohasebe/finder-unclutter","owner":"yohasebe","description":"An Alfred 🎩 workflow that removes duplicate Finder tabs and windows and arranges them into a single or dual-pane 👓 layout for a cleaner desktop experience 🖥️ 🧹","archived":false,"fork":false,"pushed_at":"2024-02-15T09:48:44.000Z","size":30702,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-07T16:52:00.996Z","etag":null,"topics":["alfred","finder","macos","productivity","workflow"],"latest_commit_sha":null,"homepage":"https://github.com/yohasebe/finder-unclutter","language":null,"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/yohasebe.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}},"created_at":"2024-02-09T22:22:32.000Z","updated_at":"2024-04-19T01:05:12.000Z","dependencies_parsed_at":"2024-02-09T23:43:46.694Z","dependency_job_id":null,"html_url":"https://github.com/yohasebe/finder-unclutter","commit_stats":null,"previous_names":["yohasebe/finder-unclutter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Ffinder-unclutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Ffinder-unclutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Ffinder-unclutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Ffinder-unclutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yohasebe","download_url":"https://codeload.github.com/yohasebe/finder-unclutter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223633840,"owners_count":17176860,"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":["alfred","finder","macos","productivity","workflow"],"created_at":"2024-04-11T21:11:53.875Z","updated_at":"2025-04-14T13:02:55.649Z","avatar_url":"https://github.com/yohasebe.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"# Finder Unclutter\n\nAn Alfred 🎩 workflow that removes duplicate Finder tabs and windows and arranges them into a single or dual-pane 👓 layout for a cleaner desktop experience 🖥️ 🧹\n\n\u003cimg src=\"./icons/finder-unclutter@2x.png\" width=150\u003e\n\n**Finder Unclutter** does the following all at once:\n\n- **Unminimize** all Finder windows\n- **Unduplicate** all Finder tabs\n- **Merge** all Finder windows and tabs\n- **Organize** Finder in a single/dual pane layout\n- **Position** Finder in a specified area of the desktop\n\n\u003cimg src=\"./images/screenshot.png\" width=600\u003e\n\n\u003cimg src=\"./images/finder-unclutter.gif\" width=680\u003e\n\n## Requirements\n\n- [Alfred 5](https://www.alfredapp.com/) with Powerpack\n\nThis workflow has been developed and tested on macOS Sonoma 14.3.\n\n## Installation\n\nTo install, download [Finder Unclutter Alfred Workflow](https://github.com/yohasebe/finder-unclutter/raw/main/finder-unclutter.alfredworkflow) (version 0.1.6)\n\n## Change Log\n\n- 0.1.6 (2025-02-04)\n  - Show Desktop menu item added\n\n## Setting up\n\nThis Workflow only functions properly if the language setting of Finder.app is set to **English** due to the way it interacts with Finder's interface.\n\nWhen this Workflow is launched, if the language of Finder.app is not English (`en`), a dialog will be displayed. Clicking OK will automatically change the language setting of Finder.app to English.\n\n\u003cimg src=\"./images/language-change-dialog.png\" width=200\u003e\u0026nbsp;\u0026nbsp; \n\u003cimg src=\"./images/language-changed.png\" width=200\u003e\n\nIf you want to revert the language setting of Finder back to its original state, you can do so in macOS's `System Settings` under `Language \u0026 Region` / `Applications`. A system restart may be required after changing these settings. Alternatively, you can revert it by executing the following command. Please specify `LANG_CODE` in the [ISO 639-1](https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPInternational/LanguageandLocaleIDs/LanguageandLocaleIDs.html) format as appropriate.\n\n```\ndefaults write com.apple.Finder AppleLanguages '(\"LANG_CODE\")'; killall Finder\n```\n\n## Features\n\nEach feature can be assigned a unique hotkey for quick access.\n\n#### \u003cimg src=\"./icons/mini-dual-pane.png\" width=32\u003e Unclutter → Dual-Pane\n\nOrganizes Finder tabs/windows into a double-pane Finder window. All existing tabs are collected in the primary pane.\n\nThe secondary pane will contain only one tab that displays the user-specified contents (`same as primary`, `parent`, `desktop`, or `home`).\n\nThe dual Finder pane can be placed in either `center (horizontal)`, `center (vertical)`, `fill (horizontal)`, `fill (vertical)`, `left`, `right`, `top`, or `bottom`. You can either specify the area either by using hotkeys, or by selecting one on running the workflow.\n\n\u003cimg src=\"./images/dual-pane-position.png\" width=500\u003e\n\n#### \u003cimg src=\"./icons/mini-single-pane.png\" width=32\u003e Unclutter → Single-Pane\n\nFinder tabs/windows will be organized into a single Finder window. All existing tabs will be collected in this Finder window.\n\nThe dual Finder pane can be placed in either `center`, `fill`, `left`, `right`, `top`, or `bottom`. You can either specify the area either by using hotkeys, or by selecting one on running the workflow.\n\n\u003cimg src=\"./images/single-pane-position.png\" width=500\u003e\n\n#### \u003cimg src=\"./icons/mini-toggle.png\" width=32\u003e Toggle Show/Hide Finder Windows\n\nThis feature relies on Alfreds `toggle visibility` feature.\n\n#### \u003cimg src=\"./icons/mini-close-other.png\" width=32\u003e Close Other Tabs and Windows\n\nThis will close all the non-current Finder tabs and windows.\n\n#### \u003cimg src=\"./icons/mini-close-all.png\" width=32\u003e Close All Finder Windows\n\nThis will close all the Finder tabs and windows including the current one. A confirmation dialog pops up.\n\n\u003cimg src=\"./images/close-all.png\" width=200\u003e\n\n#### \u003cimg src=\"./icons/show-desktop.png\" width=32\u003e Show Desktop\n\nShow Desktop using Mission Control's \"Show Desktop\" feature. Use the `show_desktop_keycode` environment variable if you want to change the default key code (`103`).\n\n#### \u003cimg src=\"./icons/mini-finder-unclutter.png\" width=32\u003e Open Config\n\nFor details on each of the configurable parameters, see [below](#configuration).\n\n\u003cimg src=\"./images/config.png\" width=500\u003e\n\n## Configuration\n\n#### Sidebar Width\n\nSetting the Sidebar Width to 0 will hide the sidebar. Otherwise, this value is set as the width of the sidebar (`0-500`, default = `200`).\n\n#### Sidebars in horizontal dual pane mode\n\nIf set to `single`, the sidebar is shown only in the left-hand side Finder window (default = single).\n\n#### Home folder path\n\nSpecifies the UNIX path of a new folder to open when no Finder window is present (default = `~`).\n\n#### View type in primary pane\n\nThe finder view type used on the primary pane (`list`, `icon`, `column`, or `gallery`, default = `list`).\n\n\n#### View type of secondary pane\n\nThe finder view type used on the secondary pane (`list`, `icon`, `column`, or `gallery`, default = `list`).\n\n#### Contents on secondary pane\n\nThe contents presented on the secondary pane (`same as primary`, `home`, `parent`,  `desktop`, default = `parent`)\n\n#### Wait message\n\nIf checked, \"uncluttering\" message is shown before single/dual pane Finder window appears (default = `checked`).\n\n#### Hide other apps\n\nIf checked, other apps will be hidden while the single/dual Finder pane gets displayed (default = `unchecked`).\n\n#### Reverse panes\n\nReverse the contents of the primary (left/top) and secondary (right/bottom) panes in the dual pane mode (default = `unchecked`).\n\n## Environment Variables\n\n- `show_desktop_keycode`: The keycode of the key assigned to Mission Control's \"Show Desktop\" (default = `103`).\n- `wait_in_seconds`: The number of seconds to wait before each Finder window operation is executed (default = `0.5`).\n\n## Author\n\nYoichiro Hasebe yohasebe@gmail.com\n\n## License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyohasebe%2Ffinder-unclutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyohasebe%2Ffinder-unclutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyohasebe%2Ffinder-unclutter/lists"}