{"id":13479500,"url":"https://github.com/samiyuru/custom-finder-right-click-menu","last_synced_at":"2025-03-27T09:32:55.733Z","repository":{"id":80680124,"uuid":"236283714","full_name":"samiyuru/custom-finder-right-click-menu","owner":"samiyuru","description":"This project allows macOS users to setup custom right click menu items for MacOS Finder directories.","archived":false,"fork":false,"pushed_at":"2024-04-01T10:12:24.000Z","size":4056,"stargazers_count":107,"open_issues_count":6,"forks_count":22,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-01T16:56:08.251Z","etag":null,"topics":["application","macos","utility"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/samiyuru.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-01-26T08:04:24.000Z","updated_at":"2024-07-30T23:36:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"43600232-b374-49f7-95bb-034234fbbdea","html_url":"https://github.com/samiyuru/custom-finder-right-click-menu","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samiyuru%2Fcustom-finder-right-click-menu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samiyuru%2Fcustom-finder-right-click-menu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samiyuru%2Fcustom-finder-right-click-menu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samiyuru%2Fcustom-finder-right-click-menu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samiyuru","download_url":"https://codeload.github.com/samiyuru/custom-finder-right-click-menu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222230567,"owners_count":16952662,"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":["application","macos","utility"],"created_at":"2024-07-31T16:02:17.734Z","updated_at":"2024-10-30T13:30:44.832Z","avatar_url":"https://github.com/samiyuru.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"# MacOS Finder Custom Directory Right Click Menu\n\nThis application allows you to add custom right click menu items to directories opened in MacOS Finder. \nRight click menu items can be added as shell scripts. \nThe application comes with two script files inbuilt to create new text documents in the current directory and to open terminal from the current directory.\nThe application has been tested to work on MacOS Catalina Version 10.15.2.\n\n## Download the Application\n\n[Download the app here](https://samiyuru.com/project/macOS-finder-right-click-menu).\n\nYou can download a pre built app file that is ready to run from the above link.\n\nYou can build the application from the source code on MacOS using Xcode.\n\n\n## Using the Application\n\nUsing the application is very simple. \nCopy FinderMenu.app to your \"/Applications\" directory. \nRun the FinderMenu.app once from the \"/Applications\" directory in your system to setup right click menu items.\n\nWhen you run FinderMenu.app once, the application will take the following steps to setup the right click menu items.\n\n* Install a launch agent to serve the custom right click menu items.\n* Install a Finder extension to include custom right click menu items in the Finder.\n* Create \"~/FinderMenu\" directory to place custom right click menu scripts.\n* Enable \"FinderMenuItems\" in \"System Preferences \u003e Extensions \u003e Finder Extensions\" in case it is not already enabled.\n\nRight click menu service in FinderMenu.app automatically starts with your system. \nBecause of that you do not have to run FinderMenu.app ever again unless you do not want to make changes to the menu item scripts.\nHowever, FinderMenu.app should always be present in your \"/Applications\" directory for the menus to work.\n\nFollowing gif shows how the provided \"New Text File Here\" menu item works.\n\n![alt text](Media/finder-right-click-new-text.gif \"New text File Here\")\n\nThe next gif shows how the provided \"Open Terminal Here\" menu item works.\n\n![alt text](Media/finder-right-click-open-terminal.gif \"Open Terminal Here\")\n\n## Adding Custom Menu Items\n\nAdding a new right click menu item is as simple as creating a shell script in the \"\\~/FinderMenu\" directory.\nThe shell script should accept the path to the directory as the first argument when running the script.\nFile name of the script file becomes the menu item name in the right click menu.\nWhen the menu item is clicked, the script is executed with the directory path as the first argument.\nYou can refer to the given scripts in \"\\~/FinderMenu\" for examples.\nWhen you place a new script in \"\\~/FinderMenu\", make sure to run FinderMenu.app once to refresh the right click menu with the new script.\n\n\n## Uninstall the Application\n\nYou can take the following steps if you need to completely uninstall the application form your system.\n\n* Delete the FinderMenu.app from \"/Applications\" directory.\n* Delete the \"\\~/FinderMenu\" directory.\n* Disable the finder extension by gong to \"System Preferences \u003e Extensions \u003e All\" and disabling the FinderMenu item.\n* Remove the launch agent by deleting \"\\~/Library/LaunchAgents/com.samiyuru.findermenu-service.plist\"\n\n\n## Credits\n\nThe icon used in the application is a modified version of an icon made by [Freepik](https://www.flaticon.com/authors/freepik) from [www.flaticon.com](https://www.flaticon.com). \n\n\n## License\n\nCopyright \u0026copy; Samiyuru Menik 2020.\n\nYou are permitted to use this application and source code for personal or commercial use. \nYou are not permitted to fork this project or redistribute this application or any of its content. \nBut, you are allowed to redistribute this application to others by pointing them to this web location.\nIf you modify this application you are allowed to use the modified version personally on your own but you are not allowed to redistribute the modified version.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamiyuru%2Fcustom-finder-right-click-menu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamiyuru%2Fcustom-finder-right-click-menu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamiyuru%2Fcustom-finder-right-click-menu/lists"}