{"id":13735819,"url":"https://github.com/wilfred-dev/wilfred","last_synced_at":"2025-05-08T12:31:20.105Z","repository":{"id":36931511,"uuid":"231204185","full_name":"wilfred-dev/wilfred","owner":"wilfred-dev","description":"🐿️ A CLI for managing game servers using Docker.","archived":false,"fork":false,"pushed_at":"2024-01-06T16:28:30.000Z","size":2063,"stargazers_count":36,"open_issues_count":14,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-04T03:05:35.794Z","etag":null,"topics":["cli","docker","game-server","game-servers","linux","minecraft","python","wilfred"],"latest_commit_sha":null,"homepage":"https://wilfredproject.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wilfred-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"vilhelmprytz","custom":"https://paypal.me/vilhelmprytz"}},"created_at":"2020-01-01T10:51:11.000Z","updated_at":"2024-03-18T13:30:54.000Z","dependencies_parsed_at":"2024-01-12T04:46:01.789Z","dependency_job_id":"8dd9a0ba-fd27-4506-8ca7-fe06228090e3","html_url":"https://github.com/wilfred-dev/wilfred","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wilfred-dev%2Fwilfred","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wilfred-dev%2Fwilfred/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wilfred-dev%2Fwilfred/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wilfred-dev%2Fwilfred/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wilfred-dev","download_url":"https://codeload.github.com/wilfred-dev/wilfred/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224732131,"owners_count":17360416,"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":["cli","docker","game-server","game-servers","linux","minecraft","python","wilfred"],"created_at":"2024-08-03T03:01:11.591Z","updated_at":"2024-11-15T04:30:44.096Z","avatar_url":"https://github.com/wilfred-dev.png","language":"Python","funding_links":["https://github.com/sponsors/vilhelmprytz","https://paypal.me/vilhelmprytz"],"categories":["Software"],"sub_categories":["Gameserver Management"],"readme":"# Wilfred\n\n[![.github/workflows/check.yml](https://github.com/wilfred-dev/wilfred/actions/workflows/check.yml/badge.svg)](https://github.com/wilfred-dev/wilfred/actions/workflows/check.yml)\n[![Python Versions](https://img.shields.io/pypi/pyversions/wilfred)](https://pypi.org/project/wilfred)\n[![pypi](https://img.shields.io/pypi/v/wilfred)](https://pypi.org/project/wilfred)\n[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/wilfred-dev/wilfred.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/wilfred-dev/wilfred/context:python)\n[![Total alerts](https://img.shields.io/lgtm/alerts/g/wilfred-dev/wilfred.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/wilfred-dev/wilfred/alerts/)\n[![Downloads](https://pepy.tech/badge/wilfred)](https://pepy.tech/project/wilfred)\n[![Discord](https://img.shields.io/discord/666366973072113698?label=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://wilfredproject.org/discord)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\nWilfred is a command-line interface for running and managing game servers locally. It uses Docker to run game servers in containers, which means they are completely separated. Wilfred can run any game that can run in Docker.\n\n⚠️ Wilfred is currently under development and should not be considered stable. Features may break or may not be implemented yet. Use with caution.\n\n## Documentation\n\nThe official documentation is available [here](https://docs.wilfredproject.org/en/latest/). For support, use our [Discord Chat](https://wilfredproject.org/discord). For bugs, you can open an issue [here](https://github.com/wilfred-dev/wilfred/issues).\n\n## Supported games\n\nAs long as your server can run in Docker, it can probably run using Wilfred (after some tinkering). These are the games supported by default. You can submit new games to [wilfred-dev/images](https://github.com/wilfred-dev/images).\n\n- Minecraft\n  - Vanilla Minecraft\n  - BungeeCord\n  - Paper\n  - Spigot\n  - SpongeVanilla\n  - Waterfall\n  - Bedrock\n- Mindustry\n- Multi Theft Auto\n- Voice Servers\n  - TeamSpeak 3\n  - Mumble\n\n## Installation\n\nPlease refer to the [official documentation](https://docs.wilfredproject.org/en/latest/#installation) for further installation instructions and documentation.\n\n### Quickstart\n\nMake sure you have Docker installed (see the official documentation for more info). The recommended way of installing Wilfred is via [Homebrew](https://brew.sh). Once brew is installed, Wilfred can easily be installed from the official tap.\n\n```bash\nbrew tap wilfred-dev/wilfred\nbrew install wilfred\n```\n\nWant the bleeding edge? You can install the latest commit using `--HEAD` (bugs are to be expected, don't use in production environments!).\n\n```bash\nbrew tap wilfred-dev/wilfred\nbrew install --HEAD wilfred\n```\n\nWilfred can also be installed using `pip`. You need to use **Python 3.8** or newer to run Wilfred.\n\n```bash\npip install wilfred --upgrade\n```\n\nOnce you got Wilfred installed, run `wilfred setup` to set a path for Wilfred to use to store server files.\n\n![Creating a server in Wilfred](https://raw.githubusercontent.com/wilfred-dev/wilfred/master/docs/quickstart.gif)\n\nTo create your first server, use `wilfred create`. Most values have a default value, where you can just press return to use them.\n\nWilfred will ask you which \"image\" to use. An image is a set of configuration files that defines a specific game within Wilfred. These images are not to be confused with Docker images, Wilfred images sort of wrap around the Docker images. A couple of games are already built into Wilfred, but you can also create your own.\n\nThen, Wilfred will ask you to set any environment variables (if available for that image). The environment variables differ from game to game and most of them have a default value.\n\nOnce the server is created, you can use `wilfred servers` to list available servers. To start it, use `wilfred start \u003cname\u003e`. To attach to the server console, you can use `wilfred console \u003cname\u003e`. If you want to start the server and attach to the server console in a single command, you can use `wilfred start \u003cname\u003e --console` (it will start the server and then immediately attach to the server console).\n\n## Helping\n\nThe best places to contribute are through the issue tracker and the official Discord server. For code contributions, pull requests and patches are always welcome!\n\n## Contributors ✨\n\nCreated, written, and maintained by [Vilhelm Prytz](https://github.com/vilhelmprytz).\n\nCopyright (C) 2020-2022, Vilhelm Prytz, \u003cvilhelm@prytznet.se\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilfred-dev%2Fwilfred","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwilfred-dev%2Fwilfred","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilfred-dev%2Fwilfred/lists"}