{"id":51678193,"url":"https://github.com/joaomjbraga/glowkey","last_synced_at":"2026-07-15T09:30:50.471Z","repository":{"id":354752627,"uuid":"1224818424","full_name":"joaomjbraga/glowkey","owner":"joaomjbraga","description":"Utilitário leve para backlight de teclados genéricos no Linux via Scroll Lock.","archived":false,"fork":false,"pushed_at":"2026-04-29T22:48:34.000Z","size":4006,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T23:31:08.223Z","etag":null,"topics":["shell","shell-script"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/joaomjbraga.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":"2026-04-29T16:56:23.000Z","updated_at":"2026-04-29T22:48:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/joaomjbraga/glowkey","commit_stats":null,"previous_names":["joaomjbraga/glowkey"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/joaomjbraga/glowkey","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomjbraga%2Fglowkey","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomjbraga%2Fglowkey/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomjbraga%2Fglowkey/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomjbraga%2Fglowkey/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joaomjbraga","download_url":"https://codeload.github.com/joaomjbraga/glowkey/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomjbraga%2Fglowkey/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35499864,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-15T02:00:06.706Z","response_time":131,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["shell","shell-script"],"created_at":"2026-07-15T09:30:49.433Z","updated_at":"2026-07-15T09:30:50.466Z","avatar_url":"https://github.com/joaomjbraga.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](.github/banner.png)\n\n![Shell](https://img.shields.io/badge/Shell-POSIX-blue)\n![X11](https://img.shields.io/badge/X11-Supported-green)\n![License](https://img.shields.io/badge/License-MIT-yellow)\n\n## O que é isso?\n\nGlowKey nasceu de uma frustração real. Onde tinha trocado meu teclado por um que é RGB e no Linux o LED simplesmente não ligava. Funcionava perfeitamente no Windows, mas no Linux nada, Zero. Escuridão total.\n\nPesquisei bastante, testei alternativas, nada resolveu. Até que fui mais fundo e descobri que esses teclados usam o LED do Scroll Lock (LED 3) pra controlar o backlight e esse comportamento simplesmente não é ativado por padrão em ambientes X11.\n\nA solução foi simples. O trabalho de descobrir, não tanto.\n\nEntão criei o GlowKey um script pequeno que usa `xset` pra restaurar esse controle e poupar outras pessoas do mesmo caminho.\n\n---\n\n## Para quem é\n\nSe você tem um teclado genérico com RGB que funciona no Windows mas fica apagado no Linux, provavelmente chegou no lugar certo.\n\n\u003cdiv\u003e\n \u003cimg src=\".github/exemplo.png\" width=\"780\"\u003e\n\u003c/div\u003e\n\nGlowKey foi feito especialmente para:\n\n- Teclados genéricos sem software oficial para Linux\n- Modelos OEM rebrand (aqueles que mudam só a caixinha)\n- Teclados \"Windows-only\" com iluminação RGB\n- Qualquer teclado cujo backlight responde ao LED 3 (Scroll Lock)\n\n---\n\n## Antes de instalar — teste se funciona com o seu\n\nAbra o terminal e rode:\n\n```bash\nxset led 3\n```\n\nSe a iluminação acender, ótimo. Agora apaga:\n\n```bash\nxset -led 3\n```\n\nSe apagou, o GlowKey vai funcionar pra você.\n\nSe não aconteceu nada nos dois comandos, infelizmente seu teclado usa outro mecanismo e o GlowKey não vai ajudar (pelo menos por enquanto).\n\n---\n\n## Dependências\n\nVocê vai precisar de:\n\n- Linux com sessão **X11** ativa (Wayland ainda não é suportado, mais sobre isso abaixo)\n- O utilitário `xset`, que provavelmente já está instalado, mas se não estiver:\n\n```bash\nsudo apt install x11-xserver-utils\n```\n\n### Verificando se você está no X11\n\n```bash\necho $XDG_SESSION_TYPE\n```\n\nSe retornar `x11`, pode seguir em frente.\n\n\u003e ⚠️ **Wayland:** ainda não há suporte. É algo que quero explorar futuramente, mas por enquanto o GlowKey depende do X11 pra funcionar.\n\n---\n\n## Instalação\n\n```bash\ngit clone https://github.com/joaomjbraga/glowkey.git\ncd glowkey\n./install.sh\n```\n\nApós a instalação, o GlowKey tenta ligar o backlight imediatamente. Se não estiver numa sessão X11 (ex: TTY/SSH), o estado é salvo como `on` e será ativado no próximo login gráfico.\n\nSe o comando `glowkey` não for reconhecido depois, adicione ao PATH:\n\n```bash\nexport PATH=\"$HOME/.local/share:$PATH\"\n```\n\n## Desinstalação\n\n```bash\n./uninstall.sh\n```\n\n---\n\n## Como usar\n\n```bash\nglowkey on        # Liga a iluminação\nglowkey off       # Desliga a iluminação\nglowkey toggle    # Alterna entre ligado e desligado\nglowkey status    # Mostra o estado atual\nglowkey restore   # Restaura o último estado salvo\nglowkey --help    # Mostra a ajuda\nglowkey --version  # Mostra a versão\n```\n\n---\n\n## Auto-inicialização\n\nO GlowKey salva automaticamente o estado do backlight toda vez que você usa `on`, `off` ou `toggle`. No próximo login, o estado será restaurado automaticamente via XDG Autostart. Se nunca tiver salvo um estado, o `restore` liga o backlight por omissão.\n\nPara desativar a auto-inicialização via XDG Autostart, remova o arquivo:\n\n```bash\nrm ~/.config/autostart/glowkey.desktop\n```\n\n## Contribuindo\n\nSe funcionou (ou não funcionou) com algum teclado específico, abre uma issue e me conta. Relatos de compatibilidade ajudam muito a entender quais dispositivos o projeto já alcança — e quais ainda precisam de atenção.\n\nPull requests também são bem-vindos.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaomjbraga%2Fglowkey","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoaomjbraga%2Fglowkey","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaomjbraga%2Fglowkey/lists"}