PodFlow

Podcasts para o GNOME, com os rankings e as novidades do Brasil.

App nativo para Linux feito com GTK 4, Libadwaita e GStreamer, inspirado na curadoria do Apple Podcasts Brasil (/charts e /new) e adaptado às diretrizes de design do GNOME.

Site · Baixar · Relatar um problema

Recursos

• Explorar: carrossel de destaques com a cor de cada capa, “Destaques da Semana”, “Em Alta” e prateleiras por gênero (Notícias, Comédia, Tecnologia, Sociedade e Cultura, Negócios, True Crime, Ciência e Educação).
• Rankings: Top Podcasts e Top Episódios do Brasil, de 1 a 50, com filtro por categoria.
• Ouvir Agora: Continuar Ouvindo (com barra de progresso), fila A Seguir e episódios novos dos programas que você segue.
• Biblioteca: programas seguidos com selo de novidades, episódios salvos, downloads e histórico.
• Página do programa: cabeçalho imersivo, descrição com “Ver mais” e filtros Todos / Não ouvidos / Baixados.
• Player sempre à mão: −15 s / +30 s, velocidade de 0,5× a 2,5× sem alterar o tom da voz, timer de sono (15/30/45/60 min ou fim do episódio), volume e fila retrátil com arrastar e soltar.
• Conta e sincronização (opcional): programas seguidos e progresso dos episódios em todos os seus aparelhos, com gpodder.net, Nextcloud (app GPodder Sync, login pelo navegador) ou um servidor próprio compatível com o gPodder. Conversa com AntennaPod, gPodder e Kasts, e a senha fica no chaveiro do sistema.
• Integrado ao GNOME: controles de mídia do GNOME Shell e teclas multimídia (MPRIS v2), bloqueio da suspensão enquanto toca, tema claro/escuro automático e notificações.
• Offline-first: abre com um catálogo de 12 podcasts brasileiros já na biblioteca; rankings, capas e episódios ficam em cache e os episódios podem ser baixados para ouvir sem internet.
• Busca no catálogo da Apple e adição de qualquer podcast pelo endereço do feed RSS.

Programa	Rankings	Ouvir Agora
Tema claro	Sincronização	Celular / janela estreita

Instalação

Central de Aplicativos do Ubuntu (snap)

Procure por PodFlow na Central de Aplicativos ou instale pelo terminal:

sudo snap install podflow
sudo snap connect podflow:password-manager-service   # opcional: senha da sincronização no chaveiro

A publicação na Snap Store está descrita em docs/publicar-na-central-de-apps.md.

Ubuntu 26.04 LTS (pacote .deb)

O .deb usa o GTK, a Libadwaita e o GStreamer do próprio sistema, por isso é leve (≈ 80 KB) e se integra perfeitamente ao Ubuntu.

1. Baixe podflow_0.3.0_all.deb na página de Releases.

2. Instale pelo terminal, na pasta do download:

   sudo apt install ./podflow_0.3.0_all.deb

3. Abra PodFlow no menu de aplicativos.

Requer Ubuntu 26.04 ou mais recente (GNOME 50: GTK ≥ 4.20 e Libadwaita ≥ 1.9). Para remover: sudo apt remove podflow.

Outras distribuições (Flatpak)

Compile e instale o Flatpak a partir do código-fonte (requer flatpak-builder):

flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo
git clone https://github.com/EuVinicios/Linux-Podcast.git && cd Linux-Podcast
make flatpak
flatpak run io.github.euvinicios.PodFlow

A partir do código-fonte

sudo apt install git make python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 gir1.2-graphene-1.0 \
  gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 gstreamer1.0-plugins-good gstreamer1.0-libav
git clone https://github.com/EuVinicios/Linux-Podcast.git
cd Linux-Podcast
make run                  # ou: python3 -m src
sudo make install         # opcional: instala em /usr/local

Atalhos de teclado

Ação	Atalho
Reproduzir / pausar	Espaço
Voltar 15 s / avançar 30 s	Ctrl+← / Ctrl+→
Próximo da fila	Ctrl+N
Mostrar A Seguir	Ctrl+U
Buscar	Ctrl+F
Atualizar	Ctrl+R
Todos os atalhos	Ctrl+?

Desenvolvimento

src/
├── main.py, window.py        # Adw.Application, janela, navegação e breakpoints
├── api/                      # Apple charts, iTunes Search/Lookup, parser RSS, cliente gPodder
├── core/                     # SQLite, GStreamer (playbin3 + scaletempo), fila, MPRIS, downloads,
│                             # sincronização (SyncManager) e chaveiro (libsecret)
├── ui/                       # barra lateral (AdwSidebar), telas, componentes e style.css
└── utils/                    # cache de capas, formatação pt-BR, cores, tarefas em segundo plano
tests/                        # unittest: parsers, banco, áudio, MPRIS, sync (servidor falso) e interface
tools/screenshots.py          # percorre as telas e gera capturas (também usado como teste)
tools/store_assets.py         # monta as imagens da página da Snap Store (data/store/)
snap/                         # snapcraft.yaml (core26 + extensão GNOME)
website/                      # site do projeto (GitHub Pages, HTML/CSS sem build)
build-aux/                    # lançador, empacotamento .deb, manifesto Flatpak e montagem do site

Comando	O que faz
make run	roda direto do código-fonte
make test	testes (com xvfb-run e dbus-run-session quando disponíveis)
make test-live	testa as APIs da Apple de verdade
make screenshots	regenera as capturas em data/screenshots/
make store-assets	gera as imagens da Snap Store em data/store/ (envie em snapcraft.io/podflow/listing)
make deb	gera dist/podflow_<versão>_all.deb
make flatpak	compila e instala o Flatpak localmente (requer flatpak-builder)
make snap	gera o snap (requer snapcraft e LXD)
make release	valida, testa e gera o .deb e o snap em dist/
make publish	o mesmo, e envia o snap à Snap Store e cria a release no GitHub
make website	monta o site em build/website/

Dados do usuário ficam em ~/.local/share/podflow/ (banco SQLite e downloads) e ~/.cache/podflow/ (capas). Sem rastreamento: o app conversa apenas com as APIs públicas da Apple, com os servidores de cada podcast e, se você entrar com uma conta, com o servidor de sincronização que escolher. Veja a política de privacidade.

Publicando uma versão

As versões são geradas e publicadas a partir desta máquina (os workflows do GitHub Actions ficaram só manuais):

1. Atualize VERSION em src/config.py, o CHANGELOG.md e o <releases> do metainfo (make validate confere) e leve tudo para a main.
2. make publish (ou tools/release.sh --publish --channel candidate para testar antes): roda os testes, gera o .deb e o snap, envia o snap à Snap Store e cria a release v<versão> no GitHub com o .deb, o snap e o SHA256SUMS.
3. Para atualizar o PodFlow instalado do código-fonte na sua conta: make install PREFIX=~/.local.

O passo a passo da loja (conta, LXD, Snapcraft) está em docs/publicar-na-central-de-apps.md.

Site

O site fica em website/ (HTML e CSS puros, sem dependências) e é publicado de graça pelo GitHub Pages (workflow, hoje disparado manualmente). Na primeira vez, ative em Settings → Pages → Source: GitHub Actions. Para ver localmente: make website && python3 -m http.server -d build/website.

Fontes de dados

Seção	Endpoint
Sincronização (opcional)	API v2 do gPodder (/api/2/...) ou /index.php/apps/gpoddersync/... (Nextcloud)
Top Podcasts / Top Episódios	rss.marketingtools.apple.com/api/v2/br/podcasts/top/50/{podcasts,podcast-episodes}.json
Rankings por gênero	itunes.apple.com/br/rss/toppodcasts/limit=50/genre={id}/json
Detalhes, episódios e busca	itunes.apple.com/lookup e itunes.apple.com/search
Histórico completo e notas	o feed RSS de cada podcast

Notas técnicas (verificadas em outubro de 2026):

• O host rss.applemarketingtools.com agora redireciona para rss.marketingtools.apple.com.
• A busca do iTunes ignora o parâmetro genreId, por isso as prateleiras por gênero usam os rankings por gênero.
• Os IDs antigos 1311 (Notícias) e 1315 (Ciência) foram substituídos por 1489 e 1533.
• O Café da Manhã (Folha) é exclusivo do Spotify e não tem feed público. No catálogo inicial ele foi substituído pelo Boletim Folha.

Aviso legal

O PodFlow é um projeto independente e não é afiliado, patrocinado ou endossado pela Apple Inc. “Apple Podcasts” é marca registrada da Apple Inc. Nomes, capas e áudios dos podcasts pertencem aos seus respectivos produtores e são exibidos a partir dos feeds públicos.

Licença

GPL-3.0-or-later © 2026 EuVinicios.

---

English

PodFlow is a native GNOME podcast player (Python, GTK 4, Libadwaita, GStreamer) inspired by the curation of Apple Podcasts in Brazil: top charts, an Explore page with featured shows and genre shelves, an Up Next queue, continue listening, offline downloads, a sleep timer, pitch-preserving speed control and MPRIS integration. The interface is in Brazilian Portuguese.

Followed shows and episode progress can optionally be synced with gpodder.net, Nextcloud (GPodder Sync) or any gPodder-compatible server, so it plays along with AntennaPod and Kasts.

Install it from the Ubuntu App Center (sudo snap install podflow) or, on Ubuntu 26.04+, with the .deb (sudo apt install ./podflow_0.3.0_all.deb) from the Releases page. Website: https://euvinicios.github.io/Linux-Podcast/. Licensed under GPL-3.0-or-later. Not affiliated with Apple Inc.