TUCaN URLs are automatically fixed so you can open URLs shared by others.
- Download .xpi file from https://github.com/tucan-plus/tucan-plus/releases/latest
On Android continue with the following steps:
- Go to Settings
- Scroll all the way down and click on About Firefox
- press the logo five times, it should say that the debug menu got activated
- go back
- Click on Install extension from file and select the downloaded .xpi file
- If you have a Linux kernel version older than 4.16 follow the following steps to avoid extremely slow extension loads. Note that this can make other websites slow.
- Go to chrome://geckoview/content/config.xhtml
- Set javascript.options.wasm_optimizingjit to false
- Go to https://github.com/tucan-plus/tucan-plus/releases/latest
- Right click on the .crx file and select "Save link as..." to download the extension file. Doing it this way is important, simply clicking on the link to download does not work as Chromium blocks the download.
- In the Chromium Menu, go to Extensions -> Manage Extensions
- Enable developer mode in the top right corner
- Drag and drop the downloaded file into this area
Requirements: Rustup
Recommended: VSCodium with rust-analyzer extension
Just open the project in VSCodium.
nix build -L .#extension-unpacked && (cd result && npx web-ext run --target firefox-android --android-device A209KFXV0201) # TODO make this build run a flake command
cargo test
Important: Do NOT run in nix develop environment
nix run .#test-dev
We use a fork of rustfmt to format our custom html extractor macro.
# install minimal profile
rustup toolchain install nightly-2025-09-08 --component rust-src --component rustc-dev --component llvm-tools-preview
rustup component remove --toolchain nightly-2025-09-08 rustfmt
cargo +nightly-2025-09-08 install --force --git https://github.com/tucan-plus/rustfmt --branch html-extractor-formatting rustfmt-nightly
cargo +nightly-2025-09-08 fmt
rustup toolchain install nightly-2025-09-08 --component rustfmt
cargo install --git https://github.com/mohe2015/dioxus --branch my dioxus-cli
cd crates/tucan-plus-dioxus/
dx serve --web --features api --verbose
dx build --web --features api --verbose --release --wasm-split --features wasm-split
cd ../../target/dx/tucan-plus-dioxus/release/web/public
sed -i 's/importMeta.url/import.meta.url/g' assets/tucan-plus-dioxus-*.js
npx http-server -p 8080 # need one that caches wasm
adb reverse tcp:8080 tcp:8080
rm -R /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/debug/web/public/assets/
rm -R /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/release/web/public/assets/
dx bundle --web --features direct --release --wasm-split --features "dioxus-router?/wasm-split"
ls -lh /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/release/web/public/assets/*.wasm
# in second tab
cargo install --locked bacon
cd crates/tucan-plus-api/
bacon run
cargo install diesel_cli --no-default-features --features sqlite
DATABASE_URL=file:$(mktemp) diesel database reset
# Service Workers in Firefox can't be ES Modules https://bugzilla.mozilla.org/show_bug.cgi?id=1360870
# Event handlers must be registered synchronously
cd crates/tucan-plus-service-worker/
cargo build --target wasm32-unknown-unknown
wasm-bindgen target/wasm32-unknown-unknown/debug/tucan-plus-service-worker.wasm --target no-modules --out-dir ./target/dx/tucan-plus-service-worker/debug/web/public/wasm/ --no-typescript
echo "wasm_bindgen.initSync({ module: Uint8Array.fromBase64(\"$(base64 -w0 target/dx/tucan-plus-service-worker/debug/web/public/wasm/tucan-plus-service-worker_bg.wasm)\")})" >> ./target/dx/tucan-plus-service-worker/debug/web/public/wasm/tucan-plus-service-worker.js
cp -r ./target/dx/tucan-plus-service-worker/debug/web/public/wasm/. ../tucan-plus-dioxus/assets/wasm/
# http://localhost:8080/#/
# 8.7 MB original size
# 4.8 MB seems absolute minimum
RUST_BACKTRACE=1 DIOXUS_LOG=trace,walrus::module::functions::local_function=debug,walrus::ir::traversals=debug cargo run --manifest-path ~/Documents/dioxus/packages/cli/Cargo.toml bundle --web --features direct --release --trace --wasm-split --features "dioxus-router?/wasm-split"
twiggy dominators /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/release/web/public/assets/tucan-plus-dioxus_bg-*.wasm
llvm-dwarfdump /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/release/web/public/assets/tucan-plus-dioxus_bg-*.wasm
llvm-dwarfdump /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/debug/web/public/wasm/tucan-plus-dioxus_bg.wasm
cargo run --manifest-path ~/Documents/dioxus/packages/cli/Cargo.toml serve --web --features api --verbose
# https://github.com/DioxusLabs/dioxus/issues/4237
wasm2wat /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/debug/web/public/wasm/tucan-plus-dioxus_bg.wasm | grep --color '"env"'
wasm-tools addr2line ./target/dx/tucan-plus-dioxus/debug/web/public/wasm/tucan-plus-dioxus_bg.wasm 0xc3d99e 0xb4c65d 0x86d66e 0xbcf4cf 0x8bd9d
nix shell nixpkgs#llvmPackages_21.bintools
whereis llvm-dwarfdump
git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
git pull
./emsdk install latest
./emsdk activate latest
source ./emsdk_env.sh
emsymbolizer
EMCC_DEBUG=1 ./upstream/emscripten/tools/wasm-sourcemap.py ~/Documents/tucan-plus/target/dx/tucan-plus-dioxus/debug/web/public/wasm/tucan-plus-dioxus_bg.wasm --dwarfdump /nix/store/47pcjmrcaq81frqyg66gf95f5cy2bzjl-llvm-binutils-21.1.1/bin/llvm-dwarfdump --output /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/debug/web/public/wasm/tucan-plus-dioxus_bg.wasm.map -w /home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/debug/web/public/wasm/tucan-plus-dioxus_bg.wasm --source-map-url http://127.0.0.1:8080/wasm/tucan-plus-dioxus_bg.wasm.map --sources --load-prefix /rustc/fa3155a644dd62e865825087b403646be01d4cef=/home/moritz/.rustup/toolchains/nightly-x86_64-unknown-linux-gnu/lib/rustlib/src/rust
cd crates/tucan-plus-dioxus/
dx bundle --platform web --out-dir ../../tucan-plus-extension/ --base-path public --features direct --release
Go to Firefox Extensions, click settings, debug addons. Then click load temporary add-on and select ./tucan-plus-extension/manifest.json See https://extensionworkshop.com/documentation/develop/debugging/.
podman build --output . .This will produce a tucan-plus-extension.zip in the current working directory.
https://developer.chrome.com/docs/extensions/how-to/distribute/host-on-linux#packaging
Open Chromium -> chrome://extensions/ -> Pack extension -> Choose folder -> Pack. Store private key in a secure place
chromium --pack-extension=tucan-plus-extension --pack-extension-key=/path/to/tucan-plus-extension.pemhttps://extensionworkshop.com/documentation/publish/distribute-sideloading/
ZIP the extension files.
Upload to AMO as unlisted extension and pray that it gets signed quickly.
This software consists of the tucan-connector component that extracts information from the html of TUCaN and provides it as a nicer to use programming API. The tucan-injector component can then be used to show that data with a nicer UI that is written using the Rust frontend library Dioxus and that is compiled to WebAssembly. This WebAssembly can be injected into the actual TUCaN website using an extension. Then, some pages provide an overlay with the information in a nicer format and caching.
bacon tucan-plus-api
http://localhost:3000/swagger-ui/
http://localhost:3000/api-docs/openapi.json
cargo run --bin schema > schema.json
https://editor-next.swagger.io/
.env
TUCAN_USERNAME=
TUCAN_PASSWORD=
SESSION_ID=
SESSION_KEY=
https://chromewebstore.google.com/detail/cc++-devtools-support-dwa/pdcpmagijalfljmkmjngeonclgbbannb
# https://doc.rust-lang.org/rustc/instrument-coverage.html#test-coverage
cd tucan-connector
RUSTFLAGS="-C instrument-coverage" cargo test
nix shell nixpkgs#llvmPackages_19.bintools-unwrapped
llvm-profdata merge *.profraw -o default.profdata
llvm-cov show -Xdemangler=/home/moritz/.cargo/bin/rustfilt /home/moritz/Documents/tucan-plus/target/debug/deps/tucan_connector-90eac6df256ec2c3 \
-format=html \
-output-dir=target/coverage \
-instr-profile=default.profdata \
-show-line-counts-or-regions \
-show-instantiations
xdg-open target/coverage/index.html
sudo systemctl stop firewalld.service
adb connect 172.18.61.176:43109
adb uninstall de.selfmade4u.tucanplus
dx serve --device --platform android --hotpatch --verbose
adb logcat -c
adb shell run-as de.selfmade4u.tucanplus logcat
dx bundle --platform android --device
/home/moritz/Documents/tucan-plus/target/dx/tucan-plus-dioxus/debug/android/app/app/build/outputs/apk/debug/app-debug.apk
dx serve --platform android --hotpatch --verbose
cargo run --manifest-path /home/moritz/Documents/dioxus/packages/cli/Cargo.toml serve --platform android --verbose
# grep for RustStdoutStderr
dx bundle --platform android --release
adb install target/dx/tucan-plus-dioxus/release/android/app/app/build/outputs/apk/release/app-release.apk
cargo run --manifest-path /home/moritz/Documents/dioxus/packages/cli/Cargo.toml build --platform android
dx serve --platform linux --hotpatch --verbose
cat *_registration-N383703888296780\,-N0\,-N0\,-N0_B.Sc.\ Informatik\ \(2015\).json | jq 'sort_by(.path) | del(.[].studiumsauswahl) | del(.[].entries.[].module.registration_state) | del(.[].entries.[].courses.[].[1].registration_button_link) | del(.[].entries.[].courses.[].[1].location_or_additional_info) | del(.[].entries.[].courses.[].[1].limit_and_size)' > a
cat *_registration-N376333755785484\,-N0\,-N0\,-N0_B.Sc.\ Informatik\ \(2015\).json | jq 'sort_by(.path) | del(.[].studiumsauswahl) | del(.[].entries.[].module.registration_state) | del(.[].entries.[].courses.[].[1].registration_button_link) | del(.[].entries.[].courses.[].[1].location_or_additional_info) | del(.[].entries.[].courses.[].[1].limit_and_size)' | sed 's/N376333755785484/N383703888296780/g' > b
meld a b
oh no there are different numbers for the same PO (probably for each semester?) maybe because depending on your starting semester the modules change?
seems like if you already completed a module it will not show up in registration at the other possible paths any more
also it seems like it won't show new courses etc? probably as you are only allowed to do it once?
seems like your wahlbereiche will be reduced to 3 if you complete your bachelor
inkscape -w 512 ../crates/tucan-plus-dioxus/assets/logo.svg -o logo.png