FFFF GitHub - petini96/thumbnail-generator: App golang to generat thumbnail from url · GitHub
[go: up one dir, main page]

Skip to content
Dismiss alert

About

App golang to generat thumbnail from url

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

Thumbnail Generator

Go Version Docker License: MIT

Um serviço de alta performance escrito em Go para gerar thumbnails de vídeos a partir de URLs. A aplicação é containerizada com Docker, utilizando FFmpeg para o processamento de vídeo, e oferece duas interfaces de uso: uma API REST e uma ferramenta de Linha de Comando (CLI).


▶️ Principais Funcionalidades

  • API REST & CLI: Acesse a funcionalidade através de requisições HTTP ou diretamente pelo terminal.
  • Processamento em Lote: Gere múltiplas thumbnails de uma só vez, tanto pela API (recebendo um arquivo .zip) quanto pela CLI.
  • Controle Granular: Especifique timestamp e proporção (dimensões) para cada vídeo individualmente em uma requisição em lote.
  • Eficiência: Utiliza streaming para processar os vídeos diretamente da URL sem a necessidade de baixá-los por completo em disco.
  • Containerizado com Docker: Todas as dependências (Go, FFmpeg) estão encapsuladas em um container Docker para um setup e deploy simplificados.
  • Configurável: Ajuste parâmetros do servidor e da aplicação através de variáveis de ambiente.

📁 Estrutura do Projeto

O projeto segue o layout padrão de aplicações Go, separando as responsabilidades em diferentes pacotes.

thumbnail-generator/
├── cmd/
│   ├── api/
│   │   └── main.go
│   └── cli/
│       └── main.go
├── internal/
│   ├── config/
│   │   └── config.go
│   ├── generator/
│   │   └── ffmpeg.go
│   └── server/
│       ├── handler.go
│       └── router.go
├── Dockerfile
├── docker-compose.yml
├── go.mod
└── README.md

🚀 Como Começar

Pré-requisitos

Executando a Aplicação

  1. Clone este repositório para sua máquina local.

  2. Navegue até o diretório raiz do projeto pelo terminal.

  3. Execute o seguinte comando para construir a imagem Docker e iniciar o container:

    docker-compose up --build

O servidor da API estará rodando em http://localhost:8080.

⚙️ Configuração

A aplicação pode ser configurada através de variáveis de ambiente no arquivo docker-compose.yml.

Variável de Ambiente Descrição Padrão
PORT Porta em que o servidor HTTP irá rodar. 8080
GENERATOR_TIMEOUT_SECONDS Timeout em segundos para a operação do FFmpeg. 30
HTTP_READ_TIMEOUT_SECONDS Timeout de leitura para requisições HTTP. 5
HTTP_WRITE_TIMEOUT_SECONDS Timeout de escrita para respostas HTTP. 45
HTTP_IDLE_TIMEOUT_SECONDS Timeout de inatividade para conexões HTTP. 60

🕹️ Como Usar a API REST

Endpoint 1: Gerar uma Única Thumbnail

  • Método: POST
  • URL: http://localhost:8080/api/v1/generate
  • Resposta de Sucesso: A imagem binária image/jpeg.

Exemplo com curl:

curl -X POST \
  http://localhost:8080/api/v1/generate \
  -H "Content-Type: application/json" \
  -d '{"url": "[https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4](https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4)", "timestamp": "00:00:05"}' \
  -o minha_thumbnail.jpg

Endpoint 2: Gerar Thumbnails em Lote (Avançado)

Este endpoint oferece controle granular sobre cada thumbnail.

  • Método: POST
  • URL: http://localhost:8080/api/v1/generate/advanced-batch
  • Body (JSON):
    • defaultTimestamp (opcional): Timestamp padrão.
    • defaultProportion (opcional): Proporção padrão (ex: "1280:720").
    • videos: Uma lista de tarefas, onde cada tarefa pode ter url (obrigatório), timestamp (opcional) e proportion (opcional).
  • Resposta de Sucesso: Um arquivo application/zip.

Exemplo de Payload (salve como payload.json):

{
  "defaultTimestamp": "00:00:02",
  "defaultProportion": "854:480",
  "videos": [
    {
      "url": "[https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4](https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4)",
      "timestamp": "00:00:08",
      "proportion": "1920:1080"
    },
    {
      "url": "[https://test-videos.co.uk/vids/elephantsdream/mp4/h264/360/Elephants_Dream_360_10s_2MB.mp4](https://test-videos.co.uk/vids/elephantsdream/mp4/h264/360/Elephants_Dream_360_10s_2MB.mp4)",
      "timestamp": "00:00:05"
    },
    {
      "url": "[https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4](https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4)"
    }
  ]
}

Exemplo com curl:

curl -X POST \
  http://localhost:8080/api/v1/generate/advanced-batch \
  -H "Content-Type: application/json" \
  --data-binary "@payload.json" \
  -o advanced_thumbnails.zip

⌨️ Como Usar a Linha de Comando (CLI)

1. Crie uma pasta de saída: mkdir output

2. Execute via docker-compose run:

O comando abaixo gera 2 thumbnails, uma com a proporção padrão e outra com uma específica.

docker-compose run --rm \
  -v "$(pwd)/output:/app/output" \
  thumbnail-generator \
  ./cli \
    -urls="URL_VIDEO_1.mp4,URL_VIDEO_2.mp4" \
    -time="00:00:01" \
    -proportion="1280:720" \
    -output="/app/output"
  • Os arquivos thumbnail_1.jpg e thumbnail_2.jpg aparecerão na sua pasta output.
  • -v "$(pwd)/output:/app/output" mapeia sua pasta local para a pasta do container.
  • O caminho em -output deve ser o de dentro do container.

About

App golang to generat thumbnail from url

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0