https://github.com/greymd/osx-open-winfs
Open a network file path with Windows style.
https://github.com/greymd/osx-open-winfs
automator-workflow finder macos macosx samba samba-share shell
Last synced: 12 months ago
JSON representation
Open a network file path with Windows style.
- Host: GitHub
- URL: https://github.com/greymd/osx-open-winfs
- Owner: greymd
- License: mit
- Created: 2016-03-24T12:13:55.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-05-30T11:47:00.000Z (about 5 years ago)
- Last Synced: 2025-06-21T15:06:12.180Z (about 1 year ago)
- Topics: automator-workflow, finder, macos, macosx, samba, samba-share, shell
- Language: Shell
- Size: 1.56 MB
- Stars: 12
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# osx-open-winfs
Open a network file path with Windows style.
## Features
* Supporting SMB file server.
* **Keeping its hierarchy:** Once the volume is mounted, it allows you to move to parent directory from the first path.
* **Copying feature:** Storing file/directory path with Windows style to the clipboard.
* Multi-byte character like 日本語 can be handled.
* **Authentification feature:** User & Password can be used for logging in (Fixed user can be used. Please refer to [Customize](# Customize))
## Install
* Execute following commands (**sudo privilege is necessary**).
```sh
$ git clone https://github.com/greymd/osx-open-winfs.git -b v2.1
$ cd osx-open-winfs
$ sudo make install
# /usr/local/mnt_openwinfs directory will be created.
```
Please make sure following Services are enabled.
You can check from `Service Prefereces` -> `Keyboard` -> `Shortcuts` -> `Services`.
# Usage
## GUI
### Open the path with Windows style
Drag over the text which starts with `\\`.
Then click `Services` -> `Open WinFsPath (Guest)` or `Open WinFsPath (Auth)`
* **Open WinFsPath (Guest) :** `Guest` and empty password are automatically used.
* **Open WinFsPath (Auth) :** Fill in the username and password.
### Copy the path with Windows style
Select the particular file or directory.
Then click `Services` -> `Copy WinFsPath`
## CLI
``openwinfs`` command is available.
```sh
$ openwinfs '\\192.168.1.1\VolumeName\Dirname'
```
It works even...
```sh
# Network host is bound to particular domain name.
$ openwinfs '\\fsname\VolumeName\Dirname'
# File/directory name includes multibyte characters.
$ openwinfs '\\192.168.3.33\部長専用\秘密の動画.mp4'
```
Fill in second and third arguments ,if you need authentication.
```sh
$ openwinfs '\\fsname\VolumeName\Dirname' 'username' 'password'
# "Guest" and empty password are automatically used in case of single argument.
$ openwinfs '\\fsname\VolumeName\Dirname'
```
# Customize
Let's use particular username and password ALWAYS.
1. Go to `~/Library/Services/`
2. Duplicate `~/Library/Services/Open WinFsPath (Guest).workflow`.
+ And rename it as you like. i.e, `Open WinFsPath (MyUser).workflow`
3. Double click the file, open Automator and edit it as following, and overwrite it.
```AppleScript
set theUser to "MyUsername" -- Fill in the username you want to use.
set thePass to "MyPassword" -- Fill in its password.
```
Finally, the new workflow is available.
# Uninstall
* Execute following commands under the repository's directory.
```sh
$ sudo make uninstall
# ""IF YOU MIND"", please delete /usr/local/mnt_openwinfs directory.
## Before deleting it, please make sure no volume is not mounted under /usr/local/mnt_openwinfs directory.
$ mount | /usr/bin/grep -oE '/usr/local/mnt_openwinfs/[^ ]*' | xargs -I@ umount @
## And delete it.
$ rm -r /usr/local/mnt_openwinfs
```
# License
This software is released under the MIT License, see [LICENSE](./LICENSE).