Skip to content

Latest commit

 

History

History
142 lines (102 loc) · 5.69 KB

README.md

File metadata and controls

142 lines (102 loc) · 5.69 KB

Discord App Welcome Message

.NET
CodeQL Advanced
Dependabot Updates

Aplicação criada em ASP.NET Core para enviar mensagens de boas-vindas personalizadas aos novos membros de um servidor Discord e monitorar uploads de vídeos de um canal do YouTube, enviando notificações automaticamente.

Funcionalidades

  1. Mensagem de boas-vindas:
    • Personalizável com imagem de fundo, cor sólida e texto configurável.
  2. Monitoramento de uploads do YouTube:
    • Periodicamente verifica um canal do YouTube e notifica um canal do Discord sobre novos vídeos.

Requisitos

  • Discord Bot Token: Obtenha no Discord Developer Portal.
  • ID do Canal de Boas-Vindas: ID do canal no Discord onde as mensagens de boas-vindas serão enviadas.
  • YouTube Channel ID: ID do canal do YouTube que será monitorado.
  • ID do Canal de Notificações do Discord: ID do canal no Discord para receber notificações de uploads.

Configuração

Variáveis de Ambiente

Variável Descrição Obrigatória
DISCORD_TOKEN Token do bot do Discord. Sim
WELCOME_CHANNEL_ID ID do canal no Discord para mensagens de boas-vindas. Sim
WELCOME_TEXT Texto da mensagem de boas-vindas. Não
BACKGROUND_IMAGE_URL URL da imagem de fundo para o cartão de boas-vindas. Não
BACKGROUND_COLOR Cor sólida de fundo (hexadecimal, ex.: #000000). Não
FONT_COLOR Cor do texto no cartão de boas-vindas (hexadecimal, ex.: #FFFFFF). Não
YOUTUBE_CHANNEL_ID ID do canal do YouTube que será monitorado. Não
YOUTUBE_DISCORD_CHANNEL_ID ID do canal do Discord para notificações de uploads. Não
YOUTUBE_MESSAGE_TEMPLATE Modelo de mensagem para notificações de vídeos. Ex.: {author}: {title}\n{url}. Não
YOUTUBE_WATCH_INTERVAL Intervalo em milissegundos para verificar novos vídeos no YouTube (padrão: 30000). Não

Nota: As funcionalidades do YouTube são opcionais e desativadas automaticamente se as variáveis YOUTUBE_CHANNEL_ID ou DISCORD_CHANNEL_ID não forem configuradas.

Rodando Localmente

  1. Clone o repositório:

    git clone https://github.com/CafeCOMaquina/discord-app-welcome-message.git
cd discord-app-welcome-message

  2. Configure as variáveis de ambiente no arquivo .env:

    DISCORD_TOKEN=seu-token-aqui
WELCOME_CHANNEL_ID=id-do-canal-aqui
WELCOME_TEXT=Bem-vindo(a) ao nosso servidor!
YOUTUBE_CHANNEL_ID=id-do-canal-youtube
YOUTUBE_DISCORD_CHANNEL_ID=id-do-canal-discord

  3. Execute o projeto:

    dotnet run

Usando Docker

Construir a Imagem Docker

docker build -t discord-app-welcome-message .

Executar com Docker

docker run -d \
  -e DISCORD_TOKEN=<seu-token> \
  -e WELCOME_CHANNEL_ID=<id-do-canal> \
  -e YOUTUBE_CHANNEL_ID=<id-do-canal-youtube> \
  -e YOUTUBE_DISCORD_CHANNEL_ID=<id-do-canal-discord> \
  -e YOUTUBE_MESSAGE_TEMPLATE="Novo vídeo no canal {author}: {title}\n{url}" \
  cafecomaquina/discord-app-welcome-message:latest

Usando Docker Compose

Exemplo de configuração:

version: '3.8'

services:
  discord-bot:
    image: cafecomaquina/discord-app-welcome-message:latest
    environment:
      DISCORD_TOKEN: "<seu-discord-token>"
      WELCOME_CHANNEL_ID: "<id-do-canal>"
      WELCOME_TEXT: "Bem-vindo(a) ao nosso servidor!"
      YOUTUBE_CHANNEL_ID: "<id-do-canal-youtube>"
      YOUTUBE_DISCORD_CHANNEL_ID: "<id-do-canal-discord>"
      YOUTUBE_MESSAGE_TEMPLATE: "Novo vídeo no canal {author}: {title}\n{url}"
    restart: always

Inicie com:

docker-compose up -d

Notas

  • Certifique-se de que o bot tem permissões suficientes para acessar os canais configurados.
  • Teste o bot em um ambiente de desenvolvimento antes de colocá-lo em produção.
  • O monitoramento do YouTube depende de feeds RSS e do intervalo configurado (WATCH_INTERVAL).

Contribuições

Contribuições são bem-vindas! Abra issues ou envie pull requests com melhorias ou correções.

Licença

Este projeto é licenciado sob a Licença Creative Commons Attribution-NonCommercial 4.0.
Você pode usá-lo, modificá-lo e redistribuí-lo apenas para fins NÃO comerciais, desde que atribua o devido crédito.
Para usos comerciais, entre em contato para obter permissão.