Joybox Guide

This document is a work-in-progress. Feel free to reach out on Mastodon or Twitter.

Joybox helps you organize audio and video links. You can add them to your collection, with tags if needed, and then go through them based on your mood.

You can also share a playlist from multiple platforms in one place.

Add with one click

The following 'bookmarklets' can be dragged to your browser's favourites and will do something special on click.

Queue Add the current page to your list silently and in the background.
Capture Enter notes to be added your list.

Add by pasting links or text

Text input is interpreted based on how lines are spaced. The link can be at the beginning, middle, or end of a block of text.

Two lines single-spaced:
alfa
bravo
Add one item.
Three lines single-spaced, including a link:
alfa
bravo
https://example.com
Add one item.
Two blocks double-spaced:
alfa

bravo
Add two items.
Two blocks double-spaced, each with a link:
alfa
bravo
https://example.com/1

charlie
https://example.com/2
Add two items.
Two lines single-spaced, each with a link:
alfa https://example.com/1
bravo https://example.com/2
Add two items.
Two links on the same line:
alfa https://example.com/1 https://ex
ample.com/2
Add two items.

Item catalog

On the left side of the interface, you can create, search, and select items. On the right side, you can edit the details.

Editing the same item on multiple devices at the same time can result in data loss. Editing different items should be safe.

Archive hides the item from the list unless there is filter text or the Reveal archive button was pressed.

Fetch fetches the image, metadata, and embed url.

Name is the name for the item. If this is empty, it will be overwritten when pressing Fetch.

Notes can be used for any personal comments. Any text from a capture box will be placed here.

Tags can be used to organize items and make them easier to find.

Sharing playlists

Sending a playlist

  1. Press the Stash button.
  2. Select one or more items from the list, then press OK.
  3. Re-order if necessary by dragging or pressing the arrow buttons, then press Copy link.

Receiving a playlist

The items are grouped at the top of the list in a section called Inbox. These mostly behave like any other item, but they are not editable and will not appear without clicking the shared link. Try a sample playlist.

Clear the inbox by pressing Clear inbox.

Add an inbox item to your collection by pressing the Add to collection button.

API Parameters

https://joybox.rosano.ca/play/#PARAM=TEXT

Note: this only works with a trailing slash before #.

PARAM TEXT
capture URL or plain text.
name Item name. Note: if multiple URLs are present in capture, this will set the name for all items.
inbox URL-encoded JSON array of objects.

Shortcuts

AccessKey refers to a one or more shortcut keys followed by a single character. Usually it's Alt on Windows or Control+Alt on macOS, but it changes based on your browser and operating system.

Launcher refers to the app's command runner: press Alt+Space, type the command, then press Enter to run.

Item catalog
Open capture box AccessKey+n
Submit capture box Control+Enter or Command+Enter
Archive Launcher
Unarchive Launcher
Debug Launcher
Select previous or next item, if filter field is focused Up or Down
Clear filter text and selected item, focus filter field Escape
Close, if filter field is focused Escape
Import JSON (beta) Launcher
Export JSON (beta) Launcher
Global
Open access link Launcher
Reload Launcher
Force update Launcher
Launcher Alt+Space
Global (when cloud is connected)
Copy private access link Launcher
Flush data Launcher

Add to Home screen on mobile and tablet devices

This web app can be 'installed' and used as if it were a native mobile app (with an icon, working without internet access, running as a standalone app outside of the browser).

  1. Open the app in your browser, then follow the steps based on your operating system:

iOS + Safari

  1. Tap the Share button Share button icon
  2. Tap Add to Home Screen Add to Home Screen icon

Android + Chrome

  1. Tap the More button More button icon
  2. Tap Add to home screen

What are remoteStorage and Fission?

remoteStorage and Fission are open protocols for synchronizing data between multiple devices. Both take the level of control and flexibility of something like email and bring it to your personal data. You could think of it as a USB key for your documents that you can plug into websites to work on your stuff.

You can get a remoteStorage account for free from 5apps or host your own.

You can get a Fission account for free from Fission Auth or setup your own server.