{"id":30885761,"url":"https://github.com/luis-codex/well-winget","last_synced_at":"2026-05-15T22:37:02.080Z","repository":{"id":312597681,"uuid":"1048012073","full_name":"luis-codex/well-winget","owner":"luis-codex","description":"Microcontenedor en Rust que renderiza UI web en Wayland con GTK4/WebKitGTK; ideal para barras, paneles y lanzadores.","archived":false,"fork":false,"pushed_at":"2025-08-31T22:25:21.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-08T12:22:41.108Z","etag":null,"topics":["gtk4","gtk4-layer-shell","rust","wayland","webkit","webview","widget"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luis-codex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-31T18:11:11.000Z","updated_at":"2025-08-31T22:25:24.000Z","dependencies_parsed_at":"2025-08-31T20:36:35.340Z","dependency_job_id":"980d35b6-7c92-498f-8f04-ce890557392b","html_url":"https://github.com/luis-codex/well-winget","commit_stats":null,"previous_names":["luis-codex/well-winget"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/luis-codex/well-winget","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luis-codex%2Fwell-winget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luis-codex%2Fwell-winget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luis-codex%2Fwell-winget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luis-codex%2Fwell-winget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luis-codex","download_url":"https://codeload.github.com/luis-codex/well-winget/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luis-codex%2Fwell-winget/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33082115,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gtk4","gtk4-layer-shell","rust","wayland","webkit","webview","widget"],"created_at":"2025-09-08T12:08:33.340Z","updated_at":"2026-05-15T22:37:02.052Z","avatar_url":"https://github.com/luis-codex.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# well-winget — Un widget Wayland con WebKit\n\nUn microcontenedor en Rust para interfaces web en Wayland. Echo con GTK4 + WebKitGTK 6, para que puedas construir tu propia barra, lanzador o panel en la web y mostrarlo como overlay nativo en tu compositor.\n\nEsta pensado para que sea ultra-flexible con el poder de la web para crear interfaces rápidas, animadas y totalmente personalizadas.\n\n## Características\n- Hecho en Rust (edición 2024): rendimiento nativo y seguridad de memoria.\n- Multi-monitor: crea una ventana por monitor automáticamente.\n- Overlay nativo Wayland: usa `gtk4-layer-shell` en capa `Overlay` y zona exclusiva 0 (flotante).\n- Fondo transparente real: el `WebView` utiliza RGBA con alpha.\n- Animación hover/slide: aparece al pasar el ratón y se oculta dejando un “peek”.\n- Carga desde `http://localhost:\u003cAPP_PORT\u003e/`: integrable con cualquier servidor local (Svelte/React/Vue, estático, etc.).\n- Dev extras activados: consola y herramientas de dev de WebKit para depurar tu UI.\n\n## Requisitos\n- Wayland (variable `GDK_BACKEND=wayland` se establece automáticamente).\n- WebKitGTK 6.0.\n- GTK4.\n- Rust y Cargo.\n\nEjemplo en (Arch):\n```\nsudo pacman -S webkitgtk-6.0 gtk4\n```\nEn (Debian/Ubuntu):\n```\nsudo apt install libwebkit2gtk-6.0-dev libgtk-4-dev\n```\n\n\n## Instalación y compilación\nClona y compila en modo release para generar el binario:\n```\ngit clone https://github.com/luis-codex/well-winget\ncd well-winget\ncargo build --release\n```\nEl binario queda en `target/release/well-winget`.\n\n## Inicio rápido\n1) Arranca tu UI local (ejemplo estático con Python):\n```\nmkdir -p ui \u0026\u0026 cat \u003e ui/index.html \u003c\u003c'HTML'\n\u003c!doctype html\u003e\n\u003chtml\u003e\n  \u003chead\u003e\n    \u003cmeta charset=\"utf-8\" /\u003e\n    \u003cstyle\u003e\n      html,body { margin:0; height:100%; }\n      body { display:flex; align-items:center; justify-content:center; color:#e5e7eb; background:transparent; font:16px/1.4 system-ui; }\n      .chip { padding:8px 12px; border-radius:12px; background:rgba(30,30,35,.65); backdrop-filter: blur(6px); }\n    \u003c/style\u003e\n  \u003c/head\u003e\n  \u003cbody\u003e\n    \u003cdiv class=\"chip\"\u003eHello from WebKit overlay ✨\u003c/div\u003e\n  \u003c/body\u003e\n  \u003c/html\u003e\nHTML\n\npushd ui \u003e/dev/null\npython -m http.server 2002\n```\n\n2) En otra terminal, usa el binario compilado (recomendado) o `cargo run` (desarrollo):\n```\n# Binario compilado\nAPP_PORT=2002 ./target/release/well-winget\n\n# (Opcional) Desarrollo\nAPP_PORT=2002 cargo run --release\n```\nAl pasar el ratón por el borde asignado, la ventana se desliza y muestra tu UI.\n\n## Uso del binario\n- Ejecuta el binario y apunta `APP_PORT` al puerto de tu UI.\n- Ejemplo:\n```\nAPP_PORT=2002 ./target/release/well-winget\n```\n- Instalación local opcional para tenerlo en PATH:\n```\ninstall -Dm755 target/release/well-winget ~/.local/bin/well-winget\n```\nLuego ejecútalo simplemente con:\n```\nAPP_PORT=2002 well-winget\n```\n\n## Cómo funciona\n- El binario crea una ventana por monitor y la ancla a un borde (por defecto, inferior) mediante layer-shell.\n- Embebe un `WebView` de WebKitGTK con fondo transparente y carga `http://localhost:\u003cAPP_PORT\u003e/`.\n- Implementa una animación de deslizamiento controlada por hover para mostrar/ocultar el panel.\n\n\n## Configuración\nActualmente, la configuración es mínima y se controla por:\n- `APP_PORT`: puerto del servidor UI (por defecto `2002`).\n- Constantes en `src/main.rs`:\n  - `BAR_HEIGHT` y `BAR_WIDTH`: tamaño del panel.\n  - `BAR_POS`: `Top` o `Bottom`.\n  - `PEEK`: píxeles visibles cuando está oculto.\n  - `ANIM_MS`: duración aproximada de la animación.\n\n## Rendimiento y buenas prácticas\n- Mantén la UI ligera (evita bundles enormes, usa SSR/streaming si aplica).\n- Usa `--release` y activa compresión/caché en tu servidor UI.\n- Evita repintados costosos; usa `transform/opacity` para animaciones suaves.\n\n\n## Roadmap\n- Parámetros por CLI/env para tamaño, posición, y borde.\n- Soporte para `Top/Bottom/Left/Right` y auto-size dinámico.\n- Modo barra “persistente” con `exclusive_zone` opcional.\n- IPC y APIs (ej. DBus/Unix socket) para controlar la UI.\n- Plantillas de ejemplo para barra y launcher.\n- Tests de integración básicos y CI.\n\n## Licencia\nMIT. Consulta `LICENSE` para el texto completo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluis-codex%2Fwell-winget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluis-codex%2Fwell-winget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluis-codex%2Fwell-winget/lists"}