WJURL Examples
| How to Play in Safari | Webpage creators | Wotja 23 required
For more WJURL examples see colartz.com/wotjas.
wotja://command=stopExamples (for Safari only)
What is a Wotja URL (WJURL)?
Wotja Mix or Wotja Box files ("Wotja Files") are actually text files. They have a .wotja or .wotjabox extension, but they can be opened in a text editor.
A Wotja URL ("WJURL") is simply the text in a Wotja File. It is really a kind of deep link and it always starts with wotja://
. WJURLs can be as little as 3Kb in size.
Tip: WJURLs are not just for use in webpages! You can paste a WJURL into an email, message or any text-supporting app and a 'Pro' mode user can copy it to the clipboard and then import it into Wotja. No file attachment needed!
How to Play in Safari
- Get and install the Wotja 23 App Bundle for Apple - you will need this.
- Enable the Wotja 23 App Extension for Safari:
- Safari > Preferences > Extensions > set "Wotja 23" checkbox to on.
- Tip: If you don't want to enable for this website the Wotja 23 App Extension for Safari (our website does not request or require ANY sensitive information, including passwords, phone numbers and credit cards), you can still download the mixes embedded in each page and play them directly in Wotja.
- Safari > Preferences > Extensions > set "Wotja 23" checkbox to on.
- Launch Wotja 23:
- Either tap the app icon on your iOS or macOS device to launch it in the usual manner, or;
- Web developers: Add an embedded
a href
link "wotja://command=launchapp" to your webpage.- When this link is tapped (try tapping the example link above) it will launch and foreground Wotja provided:
- The visitor already has Wotja installed, and;
- Important: If there are multiple versions of Wotja installed then this might actually launch one of those instead. Wotja V23+ is required for these Safari App Extension examples to work!
- They select "Allow" in the pop-up message "Do you want to allow this page to open 'Wotja23.app'?"
- The visitor already has Wotja installed, and;
- When this link is tapped (try tapping the example link above) it will launch and foreground Wotja provided:
- Return to Safari:
- Visit a webpage with an embedded WJURL. See the WJURL Examples.
- To stop Wotja playing:
- Either open a page that includes the text
wotja://command=stop
in it, such as this one; or- NB: This must be the first WJURL in the page (if you have others) - it can even be hidden, as it is in this page
- Leave the page (by loading a different Safari tab); or
- In the Wotja app itself, tap the bottom orange "Stop Safari Extension Player" button; or
- Tap the plugin icon in the Safari URL bar, tap the entry for the Wotja Safari Extension and in the popup menu tap the "Stop" button.
- Either open a page that includes the text
Webpage Creators
Want to find out how to embed a WJURL in a webpage?
See the "How to Wotjafy a Webpage" section in the Wotja 22 User Guide.