remixtree 0.1.16

remake scratch's remix tree feature #BringBackRemixTrees

scratch-remixtree 🫚

Tools to rebuild Scratch's remix tree feature!
🌐 Try the web version instantly: https://remixtree.alass.dev
#BringBackRemixTrees

Like it? Star the repo to help others find it and make me feel good 🥺

Demos :DD

CLI Version Project: https://scratch.mit.edu/projects/948573479/ Command: remixtree 948573479 --output tree.txt --verbose

Web Version Try it instantly at https://remixtree.alass.dev!

What is this?

Scratch removed the remix tree feature without any warning... So, here we go again, as a webapp and a CLI!

This tool fetches a project's remixes and builds a tree showing how all the remixes connect, using the official scratch API.

Features

• Web version built with FastAPI, CLI built with rich
• Async, can create large trees decently fast
• Optional verbose mode to go crazy (CLI-only)
• Save the full remix tree to a file if ya want to
• Supports max depth if you wanna show empathy for the Scratch Servers (CLI-only)
• Works on Linux, macOS, and Windows (Python 3.9+) (hopefully, if not, tell me)

---

Installation for the CLI

Recommended: using pipx (isolated, should-work):

pip install --user pipx
pipx install remixtree

Alternatively:

pip install remixtree

Basic Usage

(This is only for the CLI, the WebApp is pretty self-explanatory)

Example:

remixtree 1223809053 --depth 3 --output tree_output.txt

More options:

-h, --help: 
    get a list of flags like this one
-d, --depth:
    specify how deep the tree should go, default is unlimited
-v, --verbose:
    just try it, you'll see for yourself
-o, --output:
    probably the most important flag, specify where the tree should be saved
-c, --color:
    enable color coding by depth (disabled by default), will use rich color formatting

Example Output

└── root(1196834984)
    ├── » planet b «(1198230426)
    │   └── » planet b « remix(1212924547)
    ├── Apex Construction (BB7 Entry)(1198230627)
    ├── pinnacle constructions(1198232264)
    ├── R1(1198238918)
    │   └── R1 remix(1223273999)
    ├── ⬠ equilux branding (1198261493)
    ├── BB7 -  Keystone Works(1198288240)
    ├── AEDIFI(1198372015)
    ├── Mace - BB7 R1(1198407780)
    ... 

Feature Tracker

• ASCII tree visualization
• Async fetching
• Depth limiting
• Verbose mode
• File output
• Color coding
• Interactive tree navigation (yes, but not the original tree yet)
• Export to JSON/CSV
• Web interface
• Batch processing