Mumcord
Niżżel

Bots għal Mumble

Mumbot

Mumbot jidħol bħal persuna, b’ċertifikat tiegħu stess. Għalhekk jaħdem fuq kull server Mumble standard, mingħajr plugin u mingħajr ebda bidla fil-config tas-server. Mill-familja Mumcord, open source taħt AGPL-3.0.

v0.1.1

Żewġ bots, programm wieħed

It-tnejn jgħixu fl-istess programm, mumbot, għal Linux, Windows, macOS u bħala Docker image.

Webhook bot

Il-monitoraġġ, is-CI jew l-iskript tiegħek jibgħat request HTTP wieħed b’API key, u l-bot ipoġġi t-test f’kanal ta’ Mumble.

  • Għal kull key tagħżel f’liema kanali tista’ tikteb
  • Bold, italic, kodiċi, listi u links f’Markdown
  • Passwords tal-kanali, jerġa’ jikkonnettja wara qtugħ u identità fissa permezz taċ-ċertifikat tiegħu
  • Rate limit u tweġiba ċara jekk il-messaġġ wasalx
Terminal 
curl -X POST http://127.0.0.1:8080/message \
  -H 'X-API-Key: <your key>' \
  -d '{"channel": 1, "message": "**deploy** finished"}'
Dokumentazzjoni →

Test bot

It-tieni parteċipant skriptjat għal testijiet awtomatiċi tal-clients ta’ Mumble. It-testijiet ta’ Mumcord stess jaħdmu fuqu.

  • Ikkontrolla ċ-chat, l-istat, il-permessi u l-moderazzjoni, u stenna kundizzjonijiet
  • Doqq, irrekordja u ċċekkja l-livell tal-leħen, b’Opus veru
  • Load test jimla server lokali b’sa 1000 utent
  • Exit code 0 ifisser għadda: jidħol f’kull CI
Terminal 
printf '%s\n' 'join Lobby' 'say "<b>hello</b>"' \
  'expect message --from Alice --contains hi' \
  | mumbot --port 44738 --name Bob script
Dokumentazzjoni →

Niżżel

L-arkivju fih il-programm mumbot, ir-README u config ta’ eżempju, bot.example.toml.

Jew bħala Docker image għal amd64 u 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

Eżempji lesti ta’ Docker Compose: webhook bot, webhook bot b’server Mumble tiegħu biex tipprovah, u test bot fis-CI →

Checksums (SHA256SUMS) →

Pjan

Bħal Mumcord, Mumbot jinbena f’epics. L-Epic 2 huwa proposta mill-issues miftuħa u għad irid jiġi ppjanat fid-dettall.

  1. Epic 0

    lest v0.1.0

    Test bot

    Il-bot skriptjat mit-testijiet ta’ Mumcord, issa programm għalih.

    • Chat, stat, permessi u moderazzjoni, stennija għal kundizzjonijiet u script mode
    • Doqq, irrekordja u ċċekkja l-livell tal-leħen, b’Opus bħal f’Mumcord
    • Load test b’sa 1000 utent fuq server tat-test lokali

  2. Epic 1

    lest v0.1.0

    Webhook bot

    Messaġġi minn barra f’kanal ta’ Mumble.

    • HTTP API b’API keys u kanali permessi għal kull key
    • Markdown, passwords tal-kanali, reconnects u rate limit
    • Programmi għal Linux, Windows u macOS u Docker image
    • Minn 0.1.1: eżempji ta’ Docker Compose u dokumentazzjoni għall-config, il-command line, l-HTTP API u s-sigurtà

  3. Epic 2

    li jmiss

    Moduli, mużika u storja

    Bot wieħed isir kaxxa tal-għodda.

    • Moduli: agħżel liema bots jaħdmu fil-config jew fuq il-command line, fi programm wieħed u image waħda
    • Music bot: ibgħat MP3s jew links permezz ta’ HTTP, u l-bot idoqqhom fil-voice channel b’kju
    • History bot: iżomm iċ-chat tal-kanali li jista’ jara u jagħtih lill-utenti ta’ Mumcord li kienu offline. Qatt messaġġi privati
    • Cards tal-messaġġi: il-webhook jibgħat alerts b’titlu, kulur tal-istatus, graff u link li Mumcord juri bħala card
    • Bitrate li tista’ taġġusta għall-leħen u l-mużika, qatt ’il fuq mil-limitu tas-server
    • Peer module: jirreġistra l-utenti tas-server ma’ relay ta’ mumpeer u jgħid lil Mumcord li r-relay jeżisti

  4. Lil hinn

    aktar tard

    Ideat

    Għadu mhux ippjanat, iżda nnotat.

    • Bot li jaqra ċ-chat u jwieġeb għal commands
    • Text-to-speech jew ħsejjes ta’ alert f’kanal
    • Bot wieħed għal diversi servers jew b’diversi identitajiet
    • Whispers u messaġġi privati, tibdil tal-keys mingħajr restart, TLS integrat
    • Ftakar iċ-ċertifikat tas-server fl-ewwel kuntatt u rrifjuta wieħed mibdul

Għandek idea għal bot?

Ix-xewqat imorru fl-issues ta’ Mumbot fuq GitHub.

Ipproponi idea Kodiċi sors fuq GitHub →