Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

[Bug]: SnapShot GNOME extension is "out of date" on GNOME 51

Abierto Apto para principiantes
  • ¿Algo no está bien?
#16,881 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@Mnigos ya está trabajando en esto.

Desde el 9/10/2026.

  • #17436 de @Mnigos — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
79/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
typescript
Área
desktop

Línea de trabajo

Empieza con apps/desktop/gnome-extension/metadata.json y las pruebas de configuración de captura de GNOME y de instantáneas de Linux mencionadas en el issue: GnomeCaptureSetup.test.ts y LinuxSnapShot.dbus.test.ts. Actualiza la compatibilidad con GNOME 51 y los fixtures de la versión de los metadatos, y añade cobertura para actualizar de la versión 2 a la 3; mantén el protocolo D-Bus del servicio de captura en 2. Se considera terminado cuando la extensión se reconoce en GNOME 51 y pasan las pruebas pertinentes.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

bug via-triage
Before submitting
  • I searched existing issues and did not find a duplicate.
  • I included enough detail to reproduce or investigate the problem.
Area

apps/desktop

Steps to reproduce
  1. Upgrade to GNOME Shell 51.0 (Wayland) with T3 Code 0.0.45 and its bundled [email protected] extension (version 2) installed and enabled.
  2. Sign out and back in.
  3. Run gnome-extensions info [email protected].
Expected behavior

The bundled extension loads on GNOME 51 and is available as an active-window SnapShot backend.

Actual behavior

GNOME refuses to load it and reports State: OUT OF DATE (output below).

apps/desktop/gnome-extension/metadata.json lists "shell-version": ["45", "46", "47", "48", "49", "50"]. T3 Code's own setup check rejects 51 for the same reason: GnomeCaptureSetup.state() returns status unsupported when the bundled shell-version doesn't include the session's major version (GnomeCaptureSetup.ts#L172).

Impact

Major degradation or frequent failure

On my GNOME 51 setup, the unmodified bundled version-2 extension is marked OUT OF DATE and unavailable as a capture backend.

Version or commit

0.0.45 (t3code-bin from the AUR). The same metadata and setup checks are present at commit 611132c171f3a821bd2e32f22261135cef6330ac.

Environment

CachyOS (Arch), GNOME Shell 51.0, Wayland, kernel 7.2.9-1-cachyos, xdg-desktop-portal 1.22.1 with xdg-desktop-portal-gnome 51.0. AMD HawkPoint iGPU and NVIDIA RTX 4060 Laptop GPU.

Logs or stack traces
$ gnome-extensions info [email protected]
[email protected]
  Name: T3 Code SnapShots
  ...
  Enabled: Yes
  State: OUT OF DATE

$ gdbus call --session --dest org.freedesktop.portal.Desktop --object-path /org/freedesktop/portal/desktop \
    --method org.freedesktop.DBus.Properties.GetAll org.freedesktop.portal.Screenshot
({'AvailableTargets': <uint32 0>, 'version': <uint32 2>},)
Screenshots, recordings, or supporting files

No response

Workaround

Add "51" to shell-version in the installed extension's metadata.json under ${XDG_DATA_HOME:-$HOME/.local/share}/gnome-shell/extensions/[email protected]/, then sign out and back in. This edits only the installed copy; T3 Code's setup check still uses its bundled metadata.

I tested this locally:

  • The extension is ACTIVE, with no errors from it in the gnome-shell journal.
  • A SnapShot (Ctrl+Shift+2) of another window succeeded in about 100 ms, with the window's app name and title attached.
  • It went through the extension, not the portal. This system's Screenshot portal reports version 2 and AvailableTargets 0 (above), so backend selection falls through to gnome-extension (LinuxSnapShot.ts#L196-L211).

Static review of extension.js, captureService.js, captureFeedback.js and feedbackGeometry.js found no use of the removed, changed or deprecated APIs listed in the GNOME Shell 51 porting guide. Together with the local result, this suggests a metadata compatibility update. It is not a full GNOME 51 regression test.

Proposed fix

Add "51" to shell-version and bump metadata version from 2 to 3. The bump makes existing version-2 installations eligible for replacement through T3 Code's setup flow: state() requires a higher bundled version for update-required (L189), and perform("install-extension") accepts only not-installed or update-required (L229). Adding "51" while keeping version 2 would not make those installations eligible through this flow. Installing the update still requires signing out and back in.

In apps/desktop/gnome-extension/metadata.json:

-  "shell-version": ["45", "46", "47", "48", "49", "50"],
+  "shell-version": ["45", "46", "47", "48", "49", "50", "51"],
-  "version": 2,
+  "version": 3,

The tests need updating too:

  • GnomeCaptureSetup.test.ts currently uses { shell: "51.0" } as its unsupported example (L126). It also has current-version fixtures at version: 2.
  • LinuxSnapShot.dbus.test.ts has a metadata-version fixture at 2 (L97).
  • A test for the version-2-to-3 upgrade would cover this case.

Keep the capture service's D-Bus protocol version (get Version() in extension.js) at 2. LinuxSnapShot.ts accepts only protocol 1 or 2, and this metadata revision doesn't change the protocol.

Lenguaje dominante
TypeScript
Estrellas
24.8k
Forks
6.4k
Merge medio
8 h 58 min
PR fusionados (30 d)
278

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de pingdotgg/t3code

Todos los issues de pingdotgg/t3code

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.