Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Userscripts for Safari (iOS + macOS) #1

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion views/includes/documents/Userscript-Beginners-HOWTO.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Find your web browser in the table below, and follow the links to find out the o
  |
**[Pale Moon][palemoon]** | – | – | [Greasemonkey "Fork"][palemoon] | – | [Greasemonkey "Fork"][palemoon]
  |
**[Safari][safari]** | – | – | – | [Tampermonkey][tampermonkeyForSafari] | –
**[Safari][safari]** | – | [Userscripts][userscriptsForSafari] | – | [Tampermonkey][tampermonkeyForSafari], [Userscripts][userscriptsForSafari] | –
  |
**[SeaMonkey][seamonkey]** | – | – | [Greasemonkey Port][greasemonkeyPortForSeaMonkey]| [Greasemonkey Port][greasemonkeyPortForSeaMonkey]| [Greasemonkey Port][greasemonkeyPortForSeaMonkey]
  |
Expand All @@ -65,6 +65,8 @@ Find your web browser in the table below, and follow the links to find out the o
[tampermonkeyForOpera]: Tampermonkey-for-Opera
[tampermonkeyForSafari]: Tampermonkey-for-Safari

[userscriptsForSafari]: Userscripts-for-Safari

[violentmonkeyForChrome]: Violentmonkey-for-Chrome
[violentmonkeyForChromium]: Violentmonkey-for-Chromium
[violentmonkeyForFirefox]: Violentmonkey-for-Firefox
Expand Down
34 changes: 34 additions & 0 deletions views/includes/documents/Userscripts-for-Safari.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
## Userscripts for Safari

<img src="https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/60/80/51/60805145-b1d7-ada7-774e-5baeb7055b15/AppIcon-85-220-4-2x.png/1024x0w.webp" width="128" height="128" align="right">
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any chance at getting the SVG of this?

Copy link
Author

@luckydonald luckydonald Jan 17, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not that I know of any. Probably should be mirrored locally here anyway.


Userscripts for Safari by Justin Wasack.

### Installing Userscripts Extension

To get userscripts going in Userscripts, first you have to install it from the [Apple Appstore][appstoreWebsite]. Install it like any other App.

### Installing Userscripts

Once Userscripts is installed, installing userscripts from [OpenUserJS.org][oujs] is simple. Navigate to the OpenUserJS page for the script, then click the blue "Install" button at the top of the page.
You will be directed to a page showing the source code of that script.
Open the Userscripts extension, and click where it says <kbd>Userscript Detected: <u>Click To Install</u></kbd>.

<img width="413" alt="image" src="https://github.com/luckydonald-forks/OpenUserJS.org/assets/2737108/cb2565cb-e708-4e58-89d3-2e669dc9fabd">
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will have to change to something repo local eventually... but good example for now.


A confirmation dialog box should pop up, showing you details about the script and the websites it can access. Click "Install" if you want to go ahead, and you should get a confirmation that the script has been installed.

Installing userscripts from other sources is a similar process. You just need to find the installation link for the script. This will be a button or link to a file with a name that ends ".user.js"

After installing a userscript, you won't normally notice any further changes until you visit, or refresh, a website that it runs on.

### Managing Userscripts

If you click on the Userscripts Extension logo in the toolbar of safari, there is <kbd>Open Extension Page</kbd> at the buttom of the extension. This will take you to a User Scripts page in USerscripts.
This lets you enable or disable scripts as well as edit scripts and add new.



[appstoreWebsite]: https://apps.apple.com/app/userscripts/id1463298887
[oujs]: https://openuserjs.org/
[oujsScriptPageScreenshot]: https://raw.githubusercontent.com/wiki/OpenUserJS/OpenUserJS.org/images/openuserjs_script.gif "Ready to install a script"