├── Jupyter notebook from Finder.scpt ├── LICENSE ├── README.md └── imgs ├── Icon.icns └── drag-drop.png /Jupyter notebook from Finder.scpt: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lmarti/jupynb-finder-button/5a3cbcee9cdb667ea80e078a67ffe29f431bfb2e/Jupyter notebook from Finder.scpt -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2017 Luis Martí 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Launch Jupyter notebook from macOS Finder 2 | 3 | A macOS app for running a Jupyter notebook instance directly from Finder's current folder. 4 | 5 | **Important:** It is meant to be installed as a Finder toolbar button. 6 | 7 | ## Installation and usage 8 | 9 | 1. Download and unzip the [latest release of the app](https://github.com/lmarti/jupynb-finder-button/releases/latest). 10 | 2. Press the command (⌘) key and drag app to the Finder toolbar: 11 | 12 | ![drag and drop example](imgs/drag-drop.png) 13 | 14 | 3. A Jupyter notebook instance will be launched on the current folder when you click the toolbar button. 15 | 16 | ## From source 17 | 18 | 1. Clone `jupynb-finder-button` repository: 19 | ```bash 20 | git clone https://github.com/lmarti/jupynb-finder-button 21 | ``` 22 | 23 | 2. Follow Dimitrios Zacharopoulos 24 | [instructions]( https://www.youtube.com/watch?v=IGejtUXYGpA) on how to convert an AppleScript script into a macOS app. 25 | 26 | 3. A ICNS image button for the app is available. 27 | 28 | Enjoy! 29 | -------------------------------------------------------------------------------- /imgs/Icon.icns: -------------------------------------------------------------------------------- 1 | How to use this icon: 2 | 3 | Step 1: Copy the icon to the clipboard 4 | a) Click on this file from the Finder 5 | b) Choose 'Get Info' from the 'File' menu. 6 | c) In the info window that pops up, click on the icon 7 | d) Choose 'Copy' from the 'Edit' menu. 8 | e) Close the info window 9 | 10 | Step 2: Paste the icon to the desired item 11 | a) Go to the item in the Finder that you want a custom icon 12 | b) Click the item (file, folder, disk, etc) 13 | b) Choose 'Get Info' from the 'File' menu. 14 | c) In the info window that pops up, click on the icon 15 | d) Choose 'Paste' from the 'Edit' menu. 16 | e) Close the info window 17 | 18 | Step 3: 19 | Enjoy your newly customized icon! 20 | 21 | For more thorough directions, see Apple's website at: 22 | http://www.apple.com/support/mac101/customize/6/ 23 | -------------------------------------------------------------------------------- /imgs/drag-drop.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lmarti/jupynb-finder-button/5a3cbcee9cdb667ea80e078a67ffe29f431bfb2e/imgs/drag-drop.png --------------------------------------------------------------------------------