diff --git a/.cursor/environment.json b/.cursor/environment.json
index 90e46d4..d080946 100644
--- a/.cursor/environment.json
+++ b/.cursor/environment.json
@@ -1,12 +1,12 @@
{
"_comment": "Repositories Cursor's cloud environment checks out beside this one. This file is static JSON consumed by Cursor's cloud environment setup before 'install' runs, so it cannot be generated at environment-init time -- keep it converged by hand when a public repository is added or retired.",
- "install": "bash scripts/cloud-workspace-install.sh && bash scripts/cloud-python-deps.sh && bash scripts/cloud-pydevices-examples-dev-env.sh",
+ "install": "bash scripts/cloud-workspace-install.sh && bash scripts/cloud-python-deps.sh && bash scripts/cloud-gallery-dev-env.sh",
"start": "true",
"repositoryDependencies": [
"github.com/PyDevices/.github",
"github.com/PyDevices/PyDevices.github.io",
"github.com/PyDevices/pydevices",
- "github.com/PyDevices/pydevices-examples",
+ "github.com/PyDevices/gallery",
"github.com/PyDevices/audiodsp",
"github.com/PyDevices/pygraphics",
"github.com/PyDevices/palettes",
diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
index 6679863..4d9061c 100644
--- a/.github/ISSUE_TEMPLATE/bug.yml
+++ b/.github/ISSUE_TEMPLATE/bug.yml
@@ -14,7 +14,7 @@ body:
attributes:
label: Repo / area
description: Which repo (or part of a repo) is this about?
- placeholder: e.g. pydevices / displaydev, or pydevices-examples / examples
+ placeholder: e.g. pydevices / displaydev, or gallery / examples
validations:
required: true
diff --git a/.github/ISSUE_TEMPLATE/feature.yml b/.github/ISSUE_TEMPLATE/feature.yml
index 021c71e..882485e 100644
--- a/.github/ISSUE_TEMPLATE/feature.yml
+++ b/.github/ISSUE_TEMPLATE/feature.yml
@@ -8,7 +8,7 @@ body:
Thanks for the suggestion! Check the repo's ROADMAP.md first: it
may already be planned. For open-ended questions or discussion,
consider starting a thread in
- [pydevices-examples Discussions](https://github.com/PyDevices/pydevices-examples/discussions)
+ [PyDevices Discussions](https://github.com/PyDevices/pydevices/discussions)
instead.
- type: input
diff --git a/.github/workflows/checks.yml b/.github/workflows/checks.yml
index eddb0a9..d5dc69a 100644
--- a/.github/workflows/checks.yml
+++ b/.github/workflows/checks.yml
@@ -75,7 +75,7 @@ jobs:
- name: Check out generator output targets
run: |
set -euo pipefail
- for repo in PyDevices.github.io pydevices pydevices-examples mip; do
+ for repo in PyDevices.github.io pydevices gallery mip; do
git clone --quiet --depth 1 "https://github.com/PyDevices/${repo}.git" \
"workspace-root/${repo}"
done
@@ -91,7 +91,7 @@ jobs:
run: |
set -euo pipefail
failed=0
- for repo in PyDevices.github.io pydevices pydevices-examples mip; do
+ for repo in PyDevices.github.io pydevices gallery mip; do
if ! git -C "workspace-root/${repo}" diff --exit-code; then
echo "::error::${repo} is out of date with data/repos_db.json -- edit the database and regenerate"
failed=1
diff --git a/.github/workflows/cold-eyes-review.yml b/.github/workflows/cold-eyes-review.yml
index cec8cc5..e478fde 100644
--- a/.github/workflows/cold-eyes-review.yml
+++ b/.github/workflows/cold-eyes-review.yml
@@ -22,7 +22,7 @@ jobs:
run: |
Q=$((($(date +%-m)-1)/3+1))
Y=$(date +%Y)
- REPOS=(pydevices palettes pdwidgets pygraphics mpftp audiodsp lvgl-bindings lvgl-python displayif workbench pydevices-examples pyscript-template android-template cmods mip micropython-pydevices)
+ REPOS=(pydevices palettes pdwidgets pygraphics mpftp audiodsp lvgl-bindings lvgl-python displayif workbench gallery pyscript-template android-template cmods mip micropython-pydevices)
N=${#REPOS[@]}
IDX=$(( ( (Y*4 + Q) * 3 ) % N ))
SAMPLE="${REPOS[$IDX]} ${REPOS[$(( (IDX+1)%N ))]} ${REPOS[$(( (IDX+2)%N ))]}"
diff --git a/assets/apps/benchmark_deck.py b/assets/apps/benchmark_deck.py
index e0526da..5588e6e 100644
--- a/assets/apps/benchmark_deck.py
+++ b/assets/apps/benchmark_deck.py
@@ -1,5 +1,5 @@
"""
-PyDevices Multi-Interpreter Benchmark (Hero Canvas App for pydevices-examples)
+PyDevices Multi-Interpreter Benchmark (Hero Canvas App for gallery)
=============================================================================
Interactive multi-interpreter execution matrix and benchmark meter:
- 5-target performance comparator (MicroPython, CircuitPython, CPython, WASM, Android)
diff --git a/assets/apps/signal_gen.py b/assets/apps/signal_gen.py
index 68a5a6e..1874a9a 100644
--- a/assets/apps/signal_gen.py
+++ b/assets/apps/signal_gen.py
@@ -49,7 +49,7 @@ def _note_name(freq):
# ---------------------------------------------------------------------------
# Signal synthesis -- a single live synthio.Note, played through the same
-# audiodev.sample_out.AudioOut contract as pydevices-examples' piano.py
+# audiodev.sample_out.AudioOut contract as gallery's piano.py
# (out = board_config.audio_out(); out.play(synth); out.attach(app) -- the
# role is a factory, and calling it is what opens the device). Toggling the note
# on/off goes through synthio's own envelope (short attack/release) rather
diff --git a/assets/css/site.css b/assets/css/site.css
index 7d69e27..1485600 100644
--- a/assets/css/site.css
+++ b/assets/css/site.css
@@ -2,7 +2,7 @@
* PyDevices — shared org site chrome
*
* Design tokens + layout primitives shared by every PyDevices GitHub Pages
- * site (org root, lvgl-bindings, pydevices-examples, and the second-wave module
+ * site (org root, lvgl-bindings, gallery, and the second-wave module
* pages). Keep this file focused on *chrome*: header/nav, hero, buttons,
* cards, footer, typography. Project-specific / demo-interpreter styles belong
* in a local stylesheet loaded after this one.
@@ -931,7 +931,7 @@ pre code {
}
/* NOT a colour override -- an unmerged twin kept for its selector weight.
- * pydevices-examples' gallery.css loads after this file and restyles
+ * gallery's gallery.css loads after this file and restyles
* .tag.featured with the same (0,2,0) specificity, so today it wins in the
* dark theme and loses to this heavier light-theme selector. Folding these
* declarations into the rule above would hand the light theme to gallery.css
diff --git a/assets/js/site-chrome.js b/assets/js/site-chrome.js
index 37ad574..6e3bed2 100644
--- a/assets/js/site-chrome.js
+++ b/assets/js/site-chrome.js
@@ -48,7 +48,7 @@
'/workbench/">Workbench' +
'Gallery ' +
+ '/gallery/gallery/" class="nav-gallery-link">Gallery' +
"" +
'' +
'/`. Serves from `main`, no workflow |
-| `pydevices-examples` | `deploy.yml` — the PyScript gallery: manifest audits and symlink replacement |
+| `gallery` | `deploy.yml` — the PyScript gallery: manifest audits and symlink replacement |
| `mip` | `deploy-mip-index-to-pages.yml` — the package index |
Every other landing page is generated by
diff --git a/profile/README.md b/profile/README.md
index 13d0526..4d96a2a 100644
--- a/profile/README.md
+++ b/profile/README.md
@@ -25,7 +25,7 @@ Standard hardware driver engine and companion reference code.
- [`pydevices`](https://github.com/PyDevices/pydevices) — Unified pure-Python hardware abstraction layer and core device contract for MicroPython, CircuitPython, CPython, direct WebAssembly, Pyodide, and Android.
- [`audiodsp`](https://github.com/PyDevices/audiodsp) — CircuitPython's audio system (audiocore, synthio, audiomixer, effects, audiomp3) ported to MicroPython and CPython, extending CircuitPython along the way: dynamics, routing, convolution, and offline rendering. On PyPI as pydevices-audiodsp; the instrument and effect libraries built on it ship from audiocomponents.
- [`audiocomponents`](https://github.com/PyDevices/audiocomponents) — The instrument and effect libraries for audiodsp: audioinstruments (55 modelled classics, from the TR-808 to the DX7) and audioeffects (45 effect classes and racks), pure Python on MicroPython and CPython. Ships as pydevices-audioinstruments and pydevices-audioeffects, each a standalone distribution on TestPyPI and a MIP package.
-- [`pydevices-examples`](https://github.com/PyDevices/pydevices-examples) — Comprehensive example code, direct MicroPython WebAssembly demos, board configurations, and multi-interpreter showcase benchmarks.
+- [`gallery`](https://github.com/PyDevices/gallery) — Comprehensive example code, direct MicroPython WebAssembly demos, board configurations, and multi-interpreter showcase benchmarks.
### Tier 2: Python Framebuffers & GUI Toolkits
diff --git a/scripts/cloud-pydevices-examples-dev-env.sh b/scripts/cloud-gallery-dev-env.sh
similarity index 74%
rename from scripts/cloud-pydevices-examples-dev-env.sh
rename to scripts/cloud-gallery-dev-env.sh
index be0bee7..9f66757 100755
--- a/scripts/cloud-pydevices-examples-dev-env.sh
+++ b/scripts/cloud-gallery-dev-env.sh
@@ -1,12 +1,12 @@
#!/usr/bin/env bash
-# Idempotent pydevices-examples desktop dev environment for the PyDevices cloud workspace.
+# Idempotent gallery desktop dev environment for the PyDevices cloud workspace.
#
# Complements cloud-workspace-install.sh and cloud-python-deps.sh:
-# - pip install pydevices-examples requirements.txt (TestPyPI runtime stack for CPython)
+# - pip install gallery requirements.txt (TestPyPI runtime stack for CPython)
# - mip install desktop board_config, appdev, palettes, pdwidgets into ~/.micropython/lib
-# - ensure shell env (PATH, PYTHONPATH, MICROPYPATH) via pydevices-examples-env.sh + bashrc hook
+# - ensure shell env (PATH, PYTHONPATH, MICROPYPATH) via gallery-env.sh + bashrc hook
#
-# Run from pydevices-examples/lib/ after sourcing pydevices-examples-env.sh (or open a new shell).
+# Run from gallery/lib/ after sourcing gallery-env.sh (or open a new shell).
# See pydevices docs/install-workflows.md (CircuitPython-compatible mip, mpy=False).
#
# Safe to re-run. Intentionally does not `set -e` on optional TestPyPI steps.
@@ -14,27 +14,27 @@ set -uo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPOS="${PYDEVICES_REPOS_ROOT:-/agent/repos}"
-EXAMPLES="${PYDEVICES_EXAMPLES_ROOT:-$REPOS/pydevices-examples}"
+EXAMPLES="${PYDEVICES_EXAMPLES_ROOT:-$REPOS/gallery}"
MIP_INDEX="https://PyDevices.github.io/mip"
MPY_LIB="${HOME}/.micropython"
BASHRC="${HOME}/.bashrc"
-ENV_FILE="${SCRIPT_DIR}/pydevices-examples-env.sh"
-BASHRC_BEGIN="# >>> pydevices pydevices-examples dev env >>>"
-BASHRC_END="# <<< pydevices pydevices-examples dev env <<<"
+ENV_FILE="${SCRIPT_DIR}/gallery-env.sh"
+BASHRC_BEGIN="# >>> pydevices gallery dev env >>>"
+BASHRC_END="# <<< pydevices gallery dev env <<<"
-log() { printf 'cloud-pydevices-examples-dev-env: %s\n' "$*"; }
+log() { printf 'cloud-gallery-dev-env: %s\n' "$*"; }
die() {
log "ERROR: $*"
exit 1
}
-# shellcheck source=pydevices-examples-env.sh
+# shellcheck source=gallery-env.sh
source "${ENV_FILE}" || die "cannot source ${ENV_FILE}"
ensure_pydevices_examples_venv() {
if [[ ! -d "$EXAMPLES" ]]; then
- die "pydevices-examples not found at $EXAMPLES"
+ die "gallery not found at $EXAMPLES"
fi
local vpy="$EXAMPLES/.venv/bin/python"
local vpip="$EXAMPLES/.venv/bin/pip"
@@ -50,7 +50,7 @@ ensure_pydevices_examples_venv() {
"$vpip" install -q --upgrade pip || true
log "pip install -r $EXAMPLES/requirements.txt"
"$vpip" install -q -r "$EXAMPLES/requirements.txt" || \
- log "warn: pydevices-examples requirements.txt install failed"
+ log "warn: gallery requirements.txt install failed"
}
ensure_micropython_bin() {
@@ -94,11 +94,11 @@ install_bashrc_hook() {
log "bashrc hook already present"
return 0
fi
- log "append pydevices-examples env hook to $BASHRC"
+ log "append gallery env hook to $BASHRC"
cat >>"$BASHRC" < requirements-dev.txt + pygame-ce + native audio/LVGL bindings
+# - gallery (flagship) -> requirements-dev.txt + pygame-ce + native audio/LVGL bindings
# - palettes pdwidgets -> ruff
#
# Safe to run on every cloud VM boot (environment.json install).
@@ -78,10 +78,10 @@ if ! python3 -c "import ensurepip" 2>/dev/null; then
exit 1
fi
-# --- pydevices-examples: flagship dev tooling + desktop backend + LVGL binding ---------
-if bin="$(ensure_venv pydevices-examples)"; then
- "$bin/pip" install -q -r "$REPOS/pydevices-examples/requirements-dev.txt" || \
- log "warn: pydevices-examples requirements-dev install failed"
+# --- gallery: flagship dev tooling + desktop backend + LVGL binding ---------
+if bin="$(ensure_venv gallery)"; then
+ "$bin/pip" install -q -r "$REPOS/gallery/requirements-dev.txt" || \
+ log "warn: gallery requirements-dev install failed"
# pygame-ce is the desktop fallback backend / Windows default (PGDisplay);
# deliberately not in requirements-dev.txt (SDL2 is the documented primary).
"$bin/pip" install -q pygame-ce || log "warn: pygame-ce install failed"
@@ -101,7 +101,7 @@ if bin="$(ensure_venv pydevices-examples)"; then
"$bin/pip" install -q -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ pydevices-lvgl || \
log "warn: pydevices-lvgl (TestPyPI) install skipped; LVGL examples unavailable"
- # Put canonical product and source-only sibling packages on pydevices-examples's
+ # Put canonical product and source-only sibling packages on gallery's
# venv path so the matrix tests the current multi-repo sources.
sp="$("$bin/python" -c 'import site; print(site.getsitepackages()[0])' 2>/dev/null)"
if [[ -n "${sp:-}" ]]; then
@@ -114,7 +114,7 @@ if bin="$(ensure_venv pydevices-examples)"; then
log "wrote $sp/pydevices_siblings.pth"
fi
else
- log "ERROR: pydevices-examples venv unavailable"
+ log "ERROR: gallery venv unavailable"
exit 1
fi
diff --git a/scripts/cloud-workspace-install.sh b/scripts/cloud-workspace-install.sh
index 83488a5..3f9fa84 100755
--- a/scripts/cloud-workspace-install.sh
+++ b/scripts/cloud-workspace-install.sh
@@ -26,7 +26,7 @@ SIBLINGS=(
mpftp
palettes
pdwidgets
- pydevices-examples
+ gallery
android-template
pyscript-template
PyDevices.github.io
@@ -188,7 +188,7 @@ ensure_lv_cpython_lvgl_symlink() {
verify_ready() {
local name missing=0
- for name in micropython-pydevices audiodsp pygraphics lvgl-bindings pydevices pydevices-examples palettes pdwidgets; do
+ for name in micropython-pydevices audiodsp pygraphics lvgl-bindings pydevices gallery palettes pdwidgets; do
if [[ ! -d "$REPOS/$name/.git" && ! -L "$REPOS/$name" ]]; then
log "ERROR: required repo missing: $REPOS/$name"
missing=1
@@ -225,7 +225,7 @@ link_pydevices pydevices "$REPOS/pydevices"
link_pydevices mpftp "$REPOS/mpftp"
link_pydevices palettes "$REPOS/palettes"
link_pydevices pdwidgets "$REPOS/pdwidgets"
-link_pydevices pydevices-examples "$REPOS/pydevices-examples"
+link_pydevices gallery "$REPOS/gallery"
link_pydevices android-template "$REPOS/android-template"
# The C modules (displayif, audioif, cameraif, usbhost) live inside
diff --git a/scripts/pydevices-examples-env.sh b/scripts/gallery-env.sh
similarity index 70%
rename from scripts/pydevices-examples-env.sh
rename to scripts/gallery-env.sh
index 913e66d..cf9f9ad 100755
--- a/scripts/pydevices-examples-env.sh
+++ b/scripts/gallery-env.sh
@@ -1,8 +1,8 @@
-# pydevices-examples path environment — source before running from pydevices-examples/lib/.
-# Values match pydevices-examples README.md §3.2.1 and docs/utils.md (character-for-character).
+# gallery path environment — source before running from gallery/lib/.
+# Values match gallery README.md §3.2.1 and docs/utils.md (character-for-character).
#
-# cd pydevices-examples/lib
-# source ~/gh/pydevices/dotgithub/scripts/pydevices-examples-env.sh # or this repo's path
+# cd gallery/lib
+# source ~/gh/pydevices/dotgithub/scripts/gallery-env.sh # or this repo's path
_pydevices_examples_env_root() {
if [[ -n "${PYDEVICES_EXAMPLES_ROOT:-}" && -d "${PYDEVICES_EXAMPLES_ROOT}/lib" ]]; then
@@ -12,8 +12,8 @@ _pydevices_examples_env_root() {
local repos="${PYDEVICES_REPOS_ROOT:-/agent/repos}"
local candidate
for candidate in \
- "$repos/pydevices-examples" \
- "${HOME}/gh/pydevices/pydevices-examples"; do
+ "$repos/gallery" \
+ "${HOME}/gh/pydevices/gallery"; do
if [[ -d "$candidate/lib" ]]; then
printf '%s' "$candidate"
return 0
@@ -23,7 +23,7 @@ _pydevices_examples_env_root() {
}
if ! PYDEVICES_EXAMPLES_ROOT="$(_pydevices_examples_env_root)"; then
- echo "pydevices-examples-env: pydevices-examples checkout not found (set PYDEVICES_EXAMPLES_ROOT)" >&2
+ echo "gallery-env: gallery checkout not found (set PYDEVICES_EXAMPLES_ROOT)" >&2
return 1 2>/dev/null || exit 1
fi
diff --git a/scripts/generate_sites.py b/scripts/generate_sites.py
index 6f8a4a7..0565c26 100755
--- a/scripts/generate_sites.py
+++ b/scripts/generate_sites.py
@@ -48,7 +48,7 @@ def get_card_icon(repo_name):
'micropython-pydevices': '