Mumcord
Lejupielāde

Boti Mumble

Mumbot

Mumbot pieslēdzas kā cilvēks, ar savu sertifikātu. Tāpēc tas darbojas jebkurā standarta Mumble serverī, bez spraudņa un bez izmaiņām servera konfigurācijā. No Mumcord saimes, atvērtais kods ar AGPL-3.0 licenci.

v0.1.1

Divi boti, viena programma

Abi dzīvo vienā programmā, mumbot, Linux, Windows, macOS un kā Docker attēls.

Webhook bots

Monitorings, CI vai tavs paša skripts nosūta vienu HTTP pieprasījumu ar API atslēgu, un bots ievieto tekstu Mumble kanālā.

  • Katrai atslēgai nosaki, kuros kanālos tā drīkst rakstīt
  • Treknraksts, slīpraksts, kods, saraksti un saites Markdown formātā
  • Kanālu paroles, atkārtota pieslēgšanās pēc pārrāvumiem un pastāvīga identitāte ar sertifikāta palīdzību
  • Pieprasījumu ierobežojums un skaidra atbilde, vai ziņa ir nonākusi galā
Terminal 
curl -X POST http://127.0.0.1:8080/message \
  -H 'X-API-Key: <your key>' \
  -d '{"channel": 1, "message": "**deploy** finished"}'
Dokumentācija →

Testa bots

Ar skriptu vadīts otrs dalībnieks Mumble klientu automātiskajiem testiem. Uz tā darbojas arī paša Mumcord testi.

  • Vada tērzēšanu, statusu, atļaujas un moderēšanu un gaida nosacījumus
  • Atskaņo, ieraksta un pārbauda balss līmeni, ar īstu Opus
  • Slodzes tests piepilda lokālu serveri ar līdz 1000 lietotājiem
  • Izejas kods 0 nozīmē, ka tests izturēts: der jebkurai CI
Terminal 
printf '%s\n' 'join Lobby' 'say "<b>hello</b>"' \
  'expect message --from Alice --contains hi' \
  | mumbot --port 44738 --name Bob script
Dokumentācija →

Lejupielāde

Arhīvā ir programma mumbot, README un konfigurācijas piemērs bot.example.toml.

Vai kā Docker attēls amd64 un arm64:

Docker 
docker run -d --name mumbot \
  -v "$PWD/bot.toml:/config/bot.toml:ro" \
  -v mumbot-data:/data -p 127.0.0.1:8080:8080 \
  ghcr.io/mumcord/mumbot:0.1.1

Gatavi Docker Compose piemēri: webhook bots, webhook bots ar savu Mumble serveri izmēģināšanai un testa bots CI vidē →

Kontrolsummas (SHA256SUMS) →

Ceļvedis

Tāpat kā Mumcord, arī Mumbot tiek būvēts epikos. Epic 2 ir priekšlikums no atvērtajiem pieteikumiem, un to vēl plānos detalizēti.

  1. Epic 0

    gatavs v0.1.0

    Testa bots

    Ar skriptu vadītais bots no Mumcord testiem, tagad atsevišķa programma.

    • Tērzēšana, statuss, atļaujas un moderēšana, nosacījumu gaidīšana un skripta režīms
    • Balss atskaņošana, ierakstīšana un līmeņa pārbaude, ar Opus kā Mumcord
    • Slodzes tests ar līdz 1000 lietotājiem lokālā testa serverī

  2. Epic 1

    gatavs v0.1.0

    Webhook bots

    Ziņas no ārpuses Mumble kanālā.

    • HTTP API ar API atslēgām un atļautajiem kanāliem katrai atslēgai
    • Markdown, kanālu paroles, atkārtota pieslēgšanās un pieprasījumu ierobežojums
    • Programmas Linux, Windows un macOS, kā arī Docker attēls
    • Kopš 0.1.1: Docker Compose piemēri un dokumentācija par konfigurāciju, komandrindu, HTTP API un drošību

  3. Epic 2

    nākamais

    Moduļi, mūzika un vēsture

    Viens bots kļūst par rīku komplektu.

    • Moduļi: konfigurācijā vai komandrindā izvēlies, kuri boti darbojas, vienā programmā un vienā attēlā
    • Mūzikas bots: sūti MP3 vai saites caur HTTP, un bots tos atskaņo balss kanālā ar rindu
    • Vēstures bots: glabā to kanālu tērzēšanu, kurus drīkst redzēt, un nodod to Mumcord lietotājiem, kuri bija bezsaistē. Nekad privātās ziņas
    • Ziņu kartītes: webhook sūta brīdinājumus ar virsrakstu, statusa krāsu, grafiku un saiti, ko Mumcord rāda kā kartīti
    • Regulējams bitu pārraides ātrums runai un mūzikai, nekad virs servera robežas
    • Peer modulis: reģistrē servera lietotājus mumpeer starpserverī un paziņo Mumcord, ka starpserveris pastāv

  4. Pēc tam

    vēlāk

    Idejas

    Vēl nav plānots, bet pierakstīts.

    • Bots, kas lasa tērzēšanu un atbild uz komandām
    • Teksta pārvēršana runā vai brīdinājuma skaņas kanālā
    • Viens bots vairākiem serveriem vai ar vairākām identitātēm
    • Čuksti un privātās ziņas, atslēgu maiņa bez restartēšanas, iebūvēts TLS
    • Atcerēties servera sertifikātu pirmajā saskarē un atteikt mainītu

Ideja botam?

Vēlmes nonāk Mumbot pieteikumos GitHub.

Ierosini ideju Pirmkods GitHub →