2016-06-15 22:23:09 +00:00
|
|
|
|
# OSX plugin
|
|
|
|
|
|
|
2020-03-11 18:57:46 +00:00
|
|
|
|
This plugin provides a few utilities to make it more enjoyable on macOS (previously named OSX).
|
2016-06-15 22:23:09 +00:00
|
|
|
|
|
|
|
|
|
|
To start using it, add the `osx` plugin to your plugins array in `~/.zshrc`:
|
|
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
|
plugins=(... osx)
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Original author: [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
|
|
|
|
|
2020-03-11 18:57:46 +00:00
|
|
|
|
## Commands
|
|
|
|
|
|
|
|
|
|
|
|
| Command | Description |
|
|
|
|
|
|
| :-------------- | :---------------------------------------------------- |
|
|
|
|
|
|
| `tab` | Open the current directory in a new tab |
|
|
|
|
|
|
| `split_tab` | Split the current terminal tab horizontally |
|
|
|
|
|
|
| `vsplit_tab` | Split the current terminal tab vertically |
|
|
|
|
|
|
| `ofd` | Open the current directory in a Finder window |
|
|
|
|
|
|
| `pfd` | Return the path of the frontmost Finder window |
|
|
|
|
|
|
| `pfs` | Return the current Finder selection |
|
|
|
|
|
|
| `cdf` | `cd` to the current Finder directory |
|
|
|
|
|
|
| `pushdf` | `pushd` to the current Finder directory |
|
2020-06-17 09:26:39 +00:00
|
|
|
|
| `pxd` | Return the current Xcode project directory |
|
|
|
|
|
|
| `cdx` | `cd` to the current Xcode project directory |
|
2020-03-11 18:57:46 +00:00
|
|
|
|
| `quick-look` | Quick-Look a specified file |
|
|
|
|
|
|
| `man-preview` | Open a specified man page in Preview app |
|
2020-06-17 09:26:39 +00:00
|
|
|
|
| `showfiles` | Show hidden files in Finder |
|
|
|
|
|
|
| `hidefiles` | Hide the hidden files in Finder |
|
|
|
|
|
|
| `itunes` | _DEPRECATED_. Use `music` from macOS Catalina on |
|
2020-03-11 18:57:46 +00:00
|
|
|
|
| `music` | Control Apple Music. Use `music -h` for usage details |
|
|
|
|
|
|
| `spotify` | Control Spotify and search by artist, album, track… |
|
|
|
|
|
|
| `rmdsstore` | Remove .DS\_Store files recursively in a directory |
|
2020-06-17 09:26:39 +00:00
|
|
|
|
| `btrestart` | Restart the Bluetooth daemon |
|
2020-03-11 18:57:46 +00:00
|
|
|
|
|
2017-12-14 16:01:32 +00:00
|
|
|
|
## Acknowledgements
|
|
|
|
|
|
|
|
|
|
|
|
This application makes use of the following third party scripts:
|
|
|
|
|
|
|
|
|
|
|
|
[shpotify](https://github.com/hnarayanan/shpotify)
|
|
|
|
|
|
|
2019-05-09 12:17:22 +00:00
|
|
|
|
Copyright (c) 2012–2019 [Harish Narayanan](https://harishnarayanan.org/).
|
2017-12-14 16:01:32 +00:00
|
|
|
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining
|
|
|
|
|
|
a copy of this software and associated documentation files (the
|
|
|
|
|
|
"Software"), to deal in the Software without restriction, including
|
|
|
|
|
|
without limitation the rights to use, copy, modify, merge, publish,
|
|
|
|
|
|
distribute, sublicense, and/or sell copies of the Software, and to
|
|
|
|
|
|
permit persons to whom the Software is furnished to do so, subject to
|
|
|
|
|
|
the following conditions:
|
|
|
|
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be
|
|
|
|
|
|
included in all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
|
|
|
|
THE 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.
|
