Under Development You're reading the docs for the upcoming XBackBone 4.x. Version 3.x docs are available here.
Skip to content

ScreenCloud

Windows macOS Linux Available

ScreenCloud is an open-source screen capture and file sharing app for Windows, macOS and Linux. XBackBone ships a ScreenCloud uploader plugin that you install straight from a link — no manual file editing.

Set up

  1. Sign in to your XBackBone instance.
  2. Open Integrations from your profile menu.
  3. On the ScreenCloud card, click Copy install link.
  4. In ScreenCloud, open the uploader/plugin settings and choose to install a plugin from a URL, then paste the link. ScreenCloud downloads and installs the XBackBone uploader.
  5. Select the newly installed uploader (named after your instance, e.g. XBackBone Uploader) as your active uploader.

That's it. Capture a screenshot in ScreenCloud and it uploads to your instance, with the share link ready to copy.

The install link is a signed URL that serves a small plugin package (main.py, metadata.xml, settings.ui, icon.png, and a config.json) pre-filled with your instance URL and a personal API token. The plugin uploads to the /api/v1/upload endpoint with your token as a Bearer credential and reads the resulting share URL from the response.

The plugin's name, ScreenCloud identifier, and Python class are all derived from your instance's APP_NAME. This means each XBackBone instance generates its own distinct plugin, so you can install uploaders from several instances in ScreenCloud at once without one overwriting another.

The token is granted only the resource:upload ability — enough to upload new resources; the ScreenCloud plugin has no built-in way to delete them. You can review or change the token and host later from the plugin's Upload Settings dialog inside ScreenCloud.

Keep your install link private

The link lets anyone who has it install a plugin carrying an upload token for your account — treat it like a password. If it leaks, revoke the issued tokens from Profile → Tokens; copy a fresh link to rotate them.

Troubleshooting

  • Uploads fail with a 401 / "Unauthenticated". The token was revoked or the config is stale — copy a fresh install link from Integrations and reinstall the plugin (or update the token in the plugin's settings dialog).
  • Links point to the wrong host. Copy a fresh install link after changing your instance's APP_URL; the URL is baked into the plugin config at generation time.

See also

  • ShareX / Xerahs — config-file based capture clients.
  • REST API — the endpoint the plugin uploads to, for use from any tool.

Released under the Apache 2.0 License.