Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Self-hosted: "Failed to queue transcription" logged for every video when no transcription provider is configured

Aberta
#3,517 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@prosomoalexd já está trabalhando nisso.

Desde 28/10/2026.

  • #3520 de @prosomoalexd — aberto

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
35/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Estagnada
Stack de tecnologia
nextjs, typescript
Domínio
backend

Direção de pesquisa

Start by reading apps/web/lib/queue-video-transcription.ts, apps/web/workflows/process-video.ts, and apps/web/workflows/edit-video.ts; compare their queueing behavior with queueFinalizedRecordingTranscription in apps/web/workflows/finalize-desktop-recording.ts. The issue reports an open linked pull request, so the work appears to be underway. Done means the listed entry points skip transcription when ASSEMBLY_API_KEY is absent, with the reported tests passing.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

bug
Description

On a self-hosted install without ASSEMBLY_API_KEY, every processed video logs a transcription failure, e.g.:

[media-server-webhook] Failed to queue transcription … Missing necessary environment variables

Nothing is actually broken: transcription just isn't set up. I'd expect Cap to skip transcription quietly when no provider is configured, the way queueFinalizedRecordingTranscription in apps/web/workflows/finalize-desktop-recording.ts already does (if (!serverEnv().ASSEMBLY_API_KEY) return true;).

The other entry points don't have that check:

  • queueVideoTranscription in apps/web/lib/queue-video-transcription.ts (media-server webhook, multipart complete, segment finalization)
  • queueProcessedVideoTranscription in apps/web/workflows/process-video.ts
  • queueTranscriptionRegeneration in apps/web/workflows/edit-video.ts
Reproduction
  1. Self-host cap-web + cap-media-server without ASSEMBLY_API_KEY.
  2. Record or upload a video.
  3. The web logs show the transcription failure (twice per video in our case).
Additional Context
  • Cap version: ghcr.io/capsoftware/cap-web built 2026-09-07 from c5f22d7; the same code paths are on main as of 4e2377f61
  • Operating system, version: Kubernetes, MySQL 8.0, S3-compatible storage

I have a small fix with unit tests (same early return in the three places, 9 lines + 2 tests that fail on main and pass with the fix) and am happy to open a PR if that's welcome.

Linguagem predominante
Rust
Estrelas
23.7k
Forks
2.1k
Merge médio
1d 1h
PRs com merge (30d)
694

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de CapSoftware/Cap

Todas as issues de CapSoftware/Cap

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.