Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cweirup/JoplinSafariWebClipper
Safari App Extension for Joplin Web Clipper
https://github.com/cweirup/JoplinSafariWebClipper
safari-app-extension swift
Last synced: 12 days ago
JSON representation
Safari App Extension for Joplin Web Clipper
- Host: GitHub
- URL: https://github.com/cweirup/JoplinSafariWebClipper
- Owner: cweirup
- License: mit
- Created: 2020-02-22T04:07:44.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-11-04T05:08:06.000Z (about 1 year ago)
- Last Synced: 2024-08-01T16:46:17.153Z (3 months ago)
- Topics: safari-app-extension, swift
- Language: JavaScript
- Size: 1.44 MB
- Stars: 113
- Watchers: 7
- Forks: 10
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- awesome-joplin - Web Clipper for Safari - app-extension-for-joplin-now-available/9660)]. [**Beta**] Safari Web Clipper. It does the basics: Clipping pages (complete and simplified); clipping URLs and selections; tagging; selecting folders; changing the title; checking on server status and disabling the controls if Joplin isn’t running. It’s based on the Web Clipper for Chrome and Firefox provided with Joplin, with Javascript modifications to support Safari App Extensions and, of course, a native-based UI. Some things are not implemented (complete HTML clipping and screenshot capture), but the basics are there. (Tools / Unmaintained Themes)
README
# Joplin Web Clipper for Safari
This is an Safari App Extension for a Joplin Web Clipper.
[Joplin](https://joplinapp.org "Joplin Homepage") is an open-source note taking and to-do application. It includes browser extensions for Chrome and Firefox that allows you to clip the current page/tab into Joplin. This extension is built with Javascript and React.
However, Safari now requires extensions that are at least partially based on native code (Swift or Objective-C) and must be initally run from a Mac app. This means the Web Clipper included with Joplin will not work. There is currently no Safari App Extension that I am aware of. This is my attempt at making one.
There are now three versions of the extension based on what official release version of Joplin you are using (due to changes to the underlying APIs):
* Joplin v2.1.5 or higher, use [Clipper v0.4.0](https://github.com/cweirup/JoplinSafariWebClipper/releases/tag/v0.4.0).
* This will now require you to grant permission from Joplin app when you first try to use the Clipper.
* Once permission is granted, the Clipper should work normally.
* Joplin v1.4.12 to v2.1.3, use [Clipper v0.2.0](https://github.com/cweirup/JoplinSafariWebClipper/releases/tag/v0.2.0).
* Joplin prior to v1.4.12, you need to use [Clipper v0.1.3](https://github.com/cweirup/JoplinSafariWebClipper/releases/tag/v.0.1.3).
Please note that this is very much **ALPHA** quality code at this point. The core functionality works for normal day-to-day usage (which I do), but you will find bugs and issues.
## Installation
* Download the executable either from one of the links above or from the Releases page
* Unzip the file and move the executable to the Applications folder
* Run the executable once. You’ll be prompted to enable it in Safari Extensions
* After that, you should see a button with the Joplin logo in the toolbar
* Click the extension button
* If you are using Clipper v0.2.1, you will need to do the following:
* If Joplin is running, you'll be asked to grant permission. Go over to Joplin to do that.
* If Joplin is not running, you'll see a message that it is unavailable. Start Joplin, then grant permission
## Working
* Clip URL
* Clip Complete Page (to Markdown)
* Clip Simplified Page
* Folder Selector (now remembers last folder used and supports subfolders)
* Server Status Check
* NEW - Authorization persistence
* Tags
* Clip Selection
* If you are using [StopTheMadness](http://underpassapp.com/StopTheMadness/), you will need to allow "Text selection" for "Clip Selection" to work.
## Not Working/Missing
* Clip Complete Page (to HTML)
* Clip Image Capture
I'm new at Safari App Extension development, so bear with me as we learn along together!
## License
Joplin Web Clipper is available under the MIT license. See the LICENSE.md file for more info.
