{"id":13551053,"url":"https://github.com/mumble-voip/grumble","last_synced_at":"2025-05-16T05:07:05.395Z","repository":{"id":57482938,"uuid":"924876","full_name":"mumble-voip/grumble","owner":"mumble-voip","description":"Alternative Mumble server","archived":false,"fork":false,"pushed_at":"2024-12-12T03:47:21.000Z","size":1747,"stargazers_count":283,"open_issues_count":25,"forks_count":85,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-04-08T17:16:44.739Z","etag":null,"topics":["go","mumble"],"latest_commit_sha":null,"homepage":"http://mumble.info/grumble","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mumble-voip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null},"funding":{"liberapay":"mumble"}},"created_at":"2010-09-20T13:14:57.000Z","updated_at":"2025-04-08T16:57:57.000Z","dependencies_parsed_at":"2024-08-01T12:18:46.316Z","dependency_job_id":"816c1f66-317a-45d1-9cee-9d1127f2ad2c","html_url":"https://github.com/mumble-voip/grumble","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mumble-voip%2Fgrumble","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mumble-voip%2Fgrumble/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mumble-voip%2Fgrumble/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mumble-voip%2Fgrumble/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mumble-voip","download_url":"https://codeload.github.com/mumble-voip/grumble/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254471061,"owners_count":22076585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","mumble"],"created_at":"2024-08-01T12:01:41.694Z","updated_at":"2025-05-16T05:07:00.386Z","avatar_url":"https://github.com/mumble-voip.png","language":"Go","funding_links":["https://liberapay.com/mumble"],"categories":["Go","go"],"sub_categories":[],"readme":"\nLinux CI (Travis CI):\n\n[![Build Status](https://travis-ci.com/mumble-voip/grumble.svg?branch=master)](https://travis-ci.com/mumble-voip/grumble)\n\nWindows CI (AppVeyor):\n\n[![Build status](https://ci.appveyor.com/api/projects/status/yfvg0eagpuy9kgg9/branch/master?svg=true)](https://ci.appveyor.com/project/mumble-voip/grumble/branch/master)\n\nGo:\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/mumble-voip/grumble)](https://goreportcard.com/report/github.com/mumble-voip/grumble)\n\n\nWhat is Grumble?\n================\n\nGrumble is an implementation of a server for the Mumble voice chat system. It is an alternative to Murmur, the typical Mumble server.\n\nCompiling Grumble from source\n=============================\n\nYou must have a Go 1 environment installed to build Grumble. Those are available at:\n\nhttps://golang.org/dl/\n\nOnce Go is installed, you should set up a GOPATH to avoid clobbering your Go environment's root directory with third party packages.\n\nSet up a GOPATH. On Unix, do something like this\n```shell script\n$ export GOPATH=$HOME/gocode\n$ mkdir -p $GOPATH\n```\n\nand on Windows, do something like this (for cmd.exe):\n```shell script\nc:\\\u003e set GOPATH=%USERPROFILE%\\gocode\nc:\\\u003e mkdir %GOPATH%\n```\n\nThen, it's time to install Grumble. The following line should do the trick:\n```shell script\n$ go get mumble.info/grumble/cmd/grumble\n```\n\nAnd that should be it. Grumble has been built, and is available in $GOPATH/bin as 'grumble'.\n\nProject status\n==============\n\nGrumble is pretty much feature complete, except for a few \"minor\" things.\n\nThere is no bandwidth limiting, and there is no API to remote control it.\n\nGrumble's persistence layer is very ad-hoc. It uses an append-only file to store delta updates to each server's internal data, and periodically, it syncs a server's full data to disk.\n\nGrumble is currently architected to have all data in memory. That means it's not ideal for use with very very large servers. (And large servers in this context are servers with many registered users, ACLs, etc.).\n\nIt is architected this way because it allowed me to write a pure-Go program with very few external dependencies, back 4-5 years ago.\n\nThe current thinking is that if registered users are taking up too much of your memory, you should use an external authenticator. But that code isn't written yet. The concept would be equivalent to Murmur's authenticator API via RPC. But a Grumble authenticator would probably be set up more akin to a webhook -- so just a URL in the config file.\n\nThen there's the API problem. You can't currently remote control Grumble. Which can make it hard to use in production. I imagine Grumble will grow an API that it makes available via HTTP. Murmur's API is already quite stateless in many regards, so it shouldn't be too much of a stretch to put a RESTful API in Grumble to do the same job.\n\nDocker\n==============\n\n## Getting the image\n\n### Building\n```shell script\n$ git clone https://github.com/mumble-voip/grumble.git\n$ cd grumble/\n$ docker build -t mumble-voip/grumble .\n```\n\n## Running\n\n### Command line\n```shell script\n$ docker run \\\n  -v $HOME/.grumble:/data \\\n  -p 64738:64738 \\\n  -p 64738:64738/udp \\\n  mumble-voip/grumble\n```\n\n### Compose\n```yaml\nversion: '3'\nservices:\n  grumble:\n    image: mumble-voip/grumble\n    ports:\n      - 64738:64738\n      - 64738:64738/udp\n    volumes:\n      - $HOME/.grumble:/data\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmumble-voip%2Fgrumble","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmumble-voip%2Fgrumble","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmumble-voip%2Fgrumble/lists"}