Skip to content

Local project share addon #8758

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.

Sign up for GitHub

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

Jump to bottom
Draft
Br0tcraft wants to merge 4 commits into
base: master
Choose a base branch
from
Draft

Local project share addon #8758

Br0tcraft wants to merge 4 commits into from
+408 −0

Conversation

@Br0tcraft
Copy link

@Br0tcraft Br0tcraft commented Jan 2, 2026

Resolves #8757

Changes

This PR adds a small addon that lets you share Scratch projects directly from the editor.

It adds a “Local Share” button to the File menu, which opens a simple modal where you can enter the recipient’s IP address and port. The current project is then exported and sent to another device over HTTP, with a progress indicator shown during the upload.

I tried to keep the addon as general as possible so it can be used in different local network setups. I looked through existing addons and didn’t find anything with similar functionality. If there is overlap with another addon, I’m happy to adapt or adjust this to avoid duplication.

This is my first Scratch Addon, so I mainly followed the structure of existing addons and based the UI on the “Media Recorder” addon. I’m not fully sure if everything is done in the best possible way, but it works and follows existing patterns as closely as I could.

Reason for changes

The original idea behind this feature was to make it easier to send projects directly from the Scratch editor to ScratchEverywhere!
(https://github.com/ScratchEverywhere/ScratchEverywhere)

Without this, transferring projects often requires a separate app (for example FTP) or manually copying files via an SD card. This addon is mostly a convenience / nice-to-have feature that removes a few of those steps.

The feature does not necessarily have to be added, as I will also integrate it directly into the SE! editor.
(https://editor.scratchbox.dev/editor.html).
However, it would be really nice if this functionality were also available through Scratch Addons for general use.

Tests

Tested in Chrome and Firefox.
(In Forefox, however, you have to disable security.mixed_content.block_active_content for HTTP requests.)

I’m keeping this as a draft PR for now so I can get feedback on improvements, better ways to handle things, or anything I might have missed. Open to criticism and suggestions!

@Samq64
Copy link
Member

Samq64 commented Jan 2, 2026

The current project is then exported and sent to another device over HTTP

This is pretty vague. Could you explain the requirements and limitations?

@Br0tcraft
Copy link
Author

Br0tcraft commented Jan 2, 2026 •
edited
Loading

@Samq64
The addon requires the receiving device to be on the same local network with an http(s) server ready to accept the project. When you click the “Local Share” button, the project is exported as a .sb3 blob and sent via a POST request to http(s)://IP:Port/send, with a progress bar showing upload status. It’s mainly a convenience feature to quickly share projects between devices without manually transferring files or using another app.
(I kept it very simple. It doesn't have many features, and the error handling isn't particularly comprehensive.)

@Samq64
Copy link
Member

Samq64 commented Jan 2, 2026 •
edited
Loading

an http(s) server ready to accept the project.

Doesn't that defeat the convenience aspect? Not everyone knows how to setup an HTTP server or has Python installed.

@Br0tcraft
Copy link
Author

Br0tcraft commented Jan 2, 2026

Of course, setting up a server is some initial effort, and if this feature isn’t added, that’s completely fine. The main idea behind this addon is to enable sending projects directly to a backend integrated within the SE! runtime. In that case, the user wouldn’t need to do anything besides clicking a button in SE! on the console of their choice to receive the project straight from the Scratch editor.
For other use cases or different receivers, a compatible server needs to exist, which requires at least some programming knowledge. Once it’s set up, though, you don’t have to manually transfer the project file every time you make a change via third-party apps, USB sticks, or directly from the SD card.
If helpful, I could also create a small receiver app or script for Windows and Linux to simplify the process.

@DNin01 DNin01 added the scope: server Related to usage of off-site servers (ie. an addon that needs a server) label Jan 2, 2026
@CST1229
Copy link
Member

CST1229 commented Jan 2, 2026

This feels rather specific (requiring a cooperating application), maybe it could work better as a standalone userscript or browser extension.

@Br0tcraft
Copy link
Author

Br0tcraft commented Jan 2, 2026

Yes, it is quite specific (but I could write the necessary scripts/programs to make setting up a local server as easy as possible to keep it as general as possible, and then link the Code/project in the added addon if allowed).
My Addon doesn't necessarily have to be integrated into the Scratch addon. I'm not demanding that.
As already mentioned, this feature will definitely be built into the SE editor.
My pull request was more of a question about whether something like this could be made directly accessible via the Scratch addon.
If the addon is too specific, that's perfectly fine. I'll just delete this pr.

@Samq64 Samq64 added new addon Related to new addons to this extension. `scope: addons` should still be added. status: needs discussion Still in review or consideration labels Jan 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

new addon Related to new addons to this extension. `scope: addons` should still be added. scope: server Related to usage of off-site servers (ie. an addon that needs a server) status: needs discussion Still in review or consideration

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[New Addon] Share Scratch projects directly from the editor over the local network

4 participants

@Br0tcraft @Samq64 @CST1229 @DNin01