LA CRAIA
Streaming por Grafo de Afinidade & HUD Simbiótico de Letras
Documentação unificada do ecossistema La Craia. Uma máquina de som de guerrilha, fora dos silos corporativos, combinando reprodução gapless com pre-caching preditivo em Debian, bancada web colaborativa e companion flutuante universal.
Caderno 01: Por Que La Craia Existe
Streaming de música não é um problema resolvido. É um problema sequestrado. As plataformas dominantes monetizam o tempo de atenção do ouvinte como produto, enquanto enterram a autonomia sonora sob camadas de algoritmo treinado para maximizar permanência na plataforma — não a qualidade da experiência de quem ouve. La Craia é a resposta de bancada a esse sequestro.
Curadoria como Prisão
Spotify, YouTube Music e similares recomendam músicas que maximizam cliques patrocinados e permanência na plataforma. O gosto do ouvinte é calibrado pelo interesse comercial de gravadoras e anunciantes, não pela afinidade acústica real entre faixas.
Silêncio nos Túneis e Quedas de Rede
Serviços de streaming comerciais exigem conexão constante. Em estradas serranas, festas de campo e zonas sem cobertura, a música simplesmente para. La Craia pré-cacheia faixas por antecipação contínua e opera 100% offline no disco local quando necessário.
Interfaces Invasivas
Serviços comerciais foram desenhados para capturar a atenção com banners e publicidade. La Craia Simbiótyka projeta a letra sincronizada de forma limpa, direta e flutuante sobre qualquer aplicativo ou reprodutor, sem atrito e com autonomia total.
Grafo Próprio, Sem Telemetria
O motor de similaridade acústica roda em SQLite local no servidor central. Nenhum dado de escuta é enviado para servidores de terceiros. O grafo é seu, cresce com sua escuta e funciona sem internet.
HUD Simbiótico, Não Invasivo
O companion Android intercepta a mídia silenciosamente e projeta apenas o necessário: a letra exata, no milissegundo exato, com duck automático de volume quando o GPS fala. Sem notificações, sem banners, sem friction.
Self-hosted, Self-sufficient
Backend roda em qualquer Debian/Ubuntu com cargo run. Sem subscriptions, sem APIs pagas obrigatórias, sem rastreamento. Se o servidor Linux tiver disco e CPU, La Craia funciona para sempre.
Caderno 02: Arquitetura do Paredão (lacraia-core)
O servidor central opera em host Linux (Debian/Ubuntu). Ele combina banco SQLite local com grafo de adjacência de similaridade acústica, motor de resolução e streaming nativo em Opus com suporte a HTTP Range Requests (206 Partial Content).
Grafo em SQLite
Tabelas tracks e similarity_edges armazenam conexões ponderadas. Toda busca em fontes online é gravada localmente para alimentar autonomia futura.
Queue Daemon
Loop em background assegura que as próximas 2 faixas do grafo estejam 100% resolvidas e cacheadas em disco antes do término da música atual.
Streaming Opus 206
Servido em /cache/{id}.opus permitindo seek instantâneo com zero transcodificação adicional no momento da reprodução.
# Disparar o orquestrador com cache persistente e porta configurada: PORT=8080 LACRAIA_CACHE_DIR=/var/cache/la-craia cargo run -p lacraia-core
Caderno 03: La Craia Simbiótyka (Android HUD)
Micro-aplicativo Android em Kotlin estruturado como Foreground Service desacoplado. Não possui activity persistente e não interfere na tela cheia do condutor.
MediaSession Listener
Intercepta metadados e posições de milissegundos de qualquer reprodutor do sistema operacional sem exigir modificação no player original.
GPS Audio Ducking
Atenua automaticamente a música para 20% do volume quando Waze ou Google Maps emitem comandos de voz na rodovia, restaurando suavemente em seguida.
Overlay 56dp no WindowManager
Pílula flutuante translúcida com botões táteis (≥48dp) e letra sincronizada milissegundo a milissegundo logo acima dos alertas de trânsito.
Caderno 04: Protocolo de Sincronia WebSocket
Quando o som principal toca na central fixa (servidor Linux / Debian) e smartphones ou tablets atuam como controle e HUD, o endpoint /ws orquestra a comunicação bidirecional em JSON.
STATE_UPDATE pulsa a cada 1000ms transmitindo estado, posição atual em ms e flag de letra. Ao plugar um novo tablet, o servidor entrega o snapshot de imediato no primeiro frame.{
"type": "STATE_UPDATE",
"payload": {
"track": {
"id": "trk_01",
"title": "Rebel Rebel",
"artist": "David Bowie",
"durationMs": 274000
},
"playback": {
"state": "PLAYING",
"positionMs": 35200
},
"hasLrc": true
}
}
Caderno 05: Zine de Campo, Tooling & Roadmap
Bancada de comandos operacionais para teste local, script de automação única e o mapa de evolução da suíte automotiva.
./demo.sh --open.# Clonar e iniciar o backend com seeding automático e painel no navegador: git clone ssh://git@codeberg.org/lumenpink/lacraia.git cd lacraia ./demo.sh --port 8080 --open
# Executar o player Dioxus compilado como binário nativo WebKitGTK no Linux: cargo run -p lacraia-app --features desktop
cccp: nunca invoque git commit diretamente.Caderno 06: Manual de Identidade Visual
A estética de La Craia nasce da colisão entre o exoesqueleto segmentado do quilópode, a performance histórica e debochada de Lacraia nos palcos do funk dos anos 2000, e a gambiarra engenhosa dos paredões de som em compensado naval. O visual não é um "tema bonitinho" — é uma máquina de som furiosa, viva e visivelmente remendada.
ARTE OFICIAL · RETÍCULA HALFTONE
A aplicação La Craia presta homenagem a Lacraia (1977–2011), lendária dançarina, performer, DJ de música eletrônica e ícone travesti negra e periférica que revolucionou os palcos do funk carioca e a televisão brasileira com MC Serginho.
Com saltos acrobáticos, figurinos em cetim fluorescente e uma alegria radical e inegociável, ela desafiou o preconceito e abriu caminhos para a dissidência de corpos periféricos. O software La Craia herda sua audácia: autonomia sonora, velocidade bruta e liberdade absoluta.
Tokens Cromáticos Oficiais
docs/design-system.md no repositório.