Garun BOT

Um bot de discord para rastrear todas as músicas tocadas em canais de voz e vincular cada uma delas ao last.fm.

▪ Como utilizar

Ao utilizar o bot, é primeiro necessário vinculá-lo com sua conta do last.fm.

Para que isso possa ser feito, basta digitar $connect e o bot enviará no seu privado todas as instruções. Após isso, basta ativar o modo scrobbling digitando $scrobble on. Caso queira desativar o modo scrobbling, basta digitar $scrobble off.

Ademais, o comando $help mostrará todas as funções do bot.

▪ Conexão

Como dito, para se conectar, basta digitar $connect em qualquer canal de texto [desde que o BOT tenha permissão para leitura] ou na DM.

▪ Passo 01

O primeiro passo é clicar no link gerado pelo bot e permitir que o mesmo tenha acesso à sua conta last.fm.

▪ Passo 02

O segundo passo é digitar o comando gerado pelo bot e assim criar uma sessão com sua conta last.fm e salvar no banco de dados do bot.

▪ Demonstração

▪ Scrobbling

A opção de scrobbling pode ser ativada digitando $scrobble on e desativada digitando $scrobble off.

O bot permite que o usuário interrompa o scrobble de uma música reagindo à mensagem de scrobbling. Além do mais, o bot também permite que o usuário dê "amei" ou retire o "amei" em uma música também reagindo à mensagem de scrobbling. É claro que o "amei" registrado será encaminhado para a api do last.fm e executado na conta last.fm do usuário.

O "amei" também pode ser dado ou retirado diretamente por comando e para qualquer música, basta digitar $love [artista] - [música] para dar o "amei" e $unlove [artista] - [música] para retirar o "amei". Um exemplo disso seria $love Giles Corey - Blackest Bile ou $unlove Yung Lean - Ginseng Strip 2002.

▪ Bots Compatíveis

• Hydra;
• Tempo;
• Chip;
• Em breve, mais...

▪ Demonstração

▪ Ranks

O bot também conta com a opção de gerar um rank em formato de texto com os artistas ou albums mais escutados por um determinado usuário. Essa opção pode especificar o prazo (por exemplo, nos últimos 7 dias) e o tamanho do rank (por exemplo, top 10).

Syntax:

• $top [modo] [user] [n] [período].
  • [modo]: "artists", "albums";
  • [user]: last.fm username;
  • [n]: top [n];
  • [período]: 7day, 1month, 12month, overall.

Exemplo:

• $top artists ruan_1337 15 overall: Este comando retornará o top 15 artistas mais escutados pelo usuário ruan_1337 desde a criação de sua conta (overall).

▪ Demonstração

▪ Colagem

Apesar de conter uma opção que gera um rank em formato de texto com os albums ou artistas mais escutados por um determinado usuário em um determinado período de tempo, o bot também possui uma função capaz de gerar o mesmo rank em formato de imagem/colagem. O código para a geração das colagens foi escrito por @iShi0n.

Syntax:

• $collage [modo] [user] [NxN] [período].
  • [modo]: "artists", "albums";
  • [user]: last.fm username;
  • [NxN]: 3x3, 4x4, 5x5, 10x10;
  • [período]: 7day, 1month, 12month, overall.

Exemplos:

• $collage albums ruan_1337 5x5 7day: Gera uma colagem de tamanho 5x5 com os albums mais escutados por ruan_1337 nos últimos 7 dias (7day).
• $collage artists ruan_1337 10x10 overall: Gera uma colagem de tamanho 10x10 com os artistas mais escutados por ruan_1337 desde a criação de sua conta (overall).

▪ Demonstração

▪ Próximos Updates

• Editar scrobble reagindo à mensagem do bot!
• Player próprio de música!

~ Coded by okkvlt.