{"id":17048489,"url":"https://github.com/greymd/osx-open-winfs","last_synced_at":"2025-07-03T07:32:56.905Z","repository":{"id":85909126,"uuid":"54639390","full_name":"greymd/osx-open-winfs","owner":"greymd","description":"Open a network file path with Windows style.","archived":false,"fork":false,"pushed_at":"2021-05-30T11:47:00.000Z","size":1634,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-06-21T15:06:12.180Z","etag":null,"topics":["automator-workflow","finder","macos","macosx","samba","samba-share","shell"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/greymd.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":"2016-03-24T12:13:55.000Z","updated_at":"2023-12-05T05:00:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"623a5031-0474-448f-b861-9a398b124741","html_url":"https://github.com/greymd/osx-open-winfs","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/greymd/osx-open-winfs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greymd%2Fosx-open-winfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greymd%2Fosx-open-winfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greymd%2Fosx-open-winfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greymd%2Fosx-open-winfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/greymd","download_url":"https://codeload.github.com/greymd/osx-open-winfs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greymd%2Fosx-open-winfs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263282953,"owners_count":23442268,"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":["automator-workflow","finder","macos","macosx","samba","samba-share","shell"],"created_at":"2024-10-14T09:52:08.776Z","updated_at":"2025-07-03T07:32:56.896Z","avatar_url":"https://github.com/greymd.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# osx-open-winfs\nOpen a network file path with Windows style.\n\n![animation](./img/osx-open-winfs-movie.gif)\n\n## Features\n * Supporting SMB file server.\n * **Keeping its hierarchy:**  Once the volume is mounted, it allows you to move to parent directory from the first path.\n * **Copying feature:** Storing file/directory path with Windows style to the clipboard.\n * Multi-byte character like 日本語 can be handled.\n * **Authentification feature:** User \u0026 Password can be used for logging in (Fixed user can be used. Please refer to [Customize](# Customize))\n\n## Install\n\n* Execute following commands (**sudo privilege is necessary**).\n\n```sh\n   $ git clone https://github.com/greymd/osx-open-winfs.git -b v2.1\n   $ cd osx-open-winfs\n   $ sudo make install\n   # /usr/local/mnt_openwinfs directory will be created.\n```\n\nPlease make sure following Services are enabled.\n\n![animation](./img/service-preferences.png)\n\nYou can check from `Service Prefereces` -\u003e `Keyboard` -\u003e `Shortcuts` -\u003e `Services`.\n\n# Usage\n\n## GUI\n\n### Open the path with Windows style\n\nDrag over the text which starts with `\\\\`.\n\nThen click `Services` -\u003e `Open WinFsPath (Guest)` or `Open WinFsPath (Auth)`\n\n* **Open WinFsPath (Guest) :** `Guest` and empty password are automatically used.\n\n* **Open WinFsPath (Auth) :** Fill in the username and password.\n\n### Copy the path with Windows style\n\nSelect the particular file or directory.\n\nThen click `Services` -\u003e `Copy WinFsPath`\n\n## CLI\n\n``openwinfs`` command is available.\n\n```sh\n$ openwinfs '\\\\192.168.1.1\\VolumeName\\Dirname'\n```\n\nIt works even...\n\n```sh\n# Network host is bound to particular domain name.\n$ openwinfs '\\\\fsname\\VolumeName\\Dirname'\n\n# File/directory name includes multibyte characters.\n$ openwinfs '\\\\192.168.3.33\\部長専用\\秘密の動画.mp4'\n```\n\nFill in second and third arguments ,if you need authentication.\n\n```sh\n$ openwinfs '\\\\fsname\\VolumeName\\Dirname' 'username' 'password'\n\n# \"Guest\" and empty password are automatically used in case of single argument.\n$ openwinfs '\\\\fsname\\VolumeName\\Dirname'\n```\n\n# Customize\nLet's use particular username and password ALWAYS.\n\n1. Go to `~/Library/Services/`\n2. Duplicate `~/Library/Services/Open WinFsPath (Guest).workflow`.\n+ And rename it as you like. i.e, `Open WinFsPath (MyUser).workflow`\n3. Double click the file, open Automator and edit it as following, and overwrite it.\n\n```AppleScript\nset theUser to \"MyUsername\" -- Fill in the username you want to use.\nset thePass to \"MyPassword\" -- Fill in its password.\n```\n\n![animation](./img/customize.png)\n\nFinally, the new workflow is available.\n\n# Uninstall\n* Execute following commands under the repository's directory.\n\n```sh\n   $ sudo make uninstall\n\n   # \"\"IF YOU MIND\"\", please delete /usr/local/mnt_openwinfs directory.\n   ## Before deleting it, please make sure no volume is not mounted under /usr/local/mnt_openwinfs directory.\n   $ mount | /usr/bin/grep -oE '/usr/local/mnt_openwinfs/[^ ]*' | xargs -I@ umount @\n\n   ## And delete it.\n   $ rm -r /usr/local/mnt_openwinfs\n```\n\n# License\nThis software is released under the MIT License, see [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreymd%2Fosx-open-winfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreymd%2Fosx-open-winfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreymd%2Fosx-open-winfs/lists"}