scribble.rs

module
v0.8.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 14, 2024 License: BSD-3-Clause

README

Scribble.rs

Scribble.rs is an alternative to the web-based drawing game skribbl.io. My main problems with skribbl.io were the ads and the fact that a disconnect would cause you to lose your points. On top of that, the automatic word choice was quite annoying and caused some frustration.

The site will not display any ads or share any data with third parties.

Play now

There are some community hosted versions of the game (feel free to host your own instance and add it here!):

  • scribblers.fly.dev (Official instance, Note that the instance may not respond instantly, as it automatically shuts down if no traffic is received.)
  • scribble.bixilon.de (community instance maintained by @Bixilon)

Configuration

Configuration is read from environment variables or a .env file located in the working directory.

Available settings:

Key Description Default Required
PORT HTTP port that the server listens to. 8080 True
NETWORK_ADDRESS TCP address that the server listens to. False
ROOT_PATH Changes the path (after your domain) that the server listens to. False
CORS_ALLOWED_ORIGINS * False
CORS_ALLOW_CREDENTIALS False
LOBBY_CLEANUP_INTERVAL 90s False
LOBBY_CLEANUP_PLAYER_INACTIVITY_THRESHOLD 75s False

For more up-to-date configuration, read the config.go file.

Docker

Alternatively there's a docker container:

docker pull biosmarcel/scribble.rs:latest

Starting from v0.8.5, docker images are only built on tagged pushes. Each git tag becomes a docker tag, however latest will always point to the latest tag.

There's also biosmarcel/scribble.rs:windows-latest in case you are interested in running a native Windows container.

Building / Running

Dependencies:

  • go version 1.22 or later
  • git (You can also download a .zip from Github)

In order to download and build, open a terminal and execute:

git clone https://github.com/scribble-rs/scribble.rs.git
cd scribble.rs
go build ./cmd/scribblers .

This will produce a portable binary called scribblers or scribblers.exe if you are on Windows.

Pre-compiled binaries

In the Releases section you can find the latest stable release.

Alternatively each commit uploads artifacts which will be available for a certain time.

Changing default port

The default port is 8080. To override it, run:

docker run --pull always --env PORT=<port> -p <port>:<port> biosmarcel/scribble.rs:latest

nginx

Since Scribble.rs uses WebSockets, when running it behind an nginx reverse proxy, you have to configure nginx to support that. You will find an example configuration on the related Wiki page.

Other reverse proxies may require similar configuration. If you are using a well known reverse proxy, you are free to contribute a configuration to the wiki.

Contributing

There are many ways you can contribute:

  • Update / Add documentation in the wiki of the GitHub repository
  • Extend this README
  • Create feature requests and bug reports
  • Solve issues by creating Pull Requests
  • Tell your friends about the project

Credits

These resources are by people unrelated to the project, whilst not every of these resources requires attribution as per license, we'll do it either way ;)

If you happen to find a mistake here, please make a PR. If you are one of the authors and feel like we've wronged you, please reach out.

Some of these were slightly altered if the license allowed it. Treat each of the files in this repository with the same license terms as the original file.

Directories

Path Synopsis
cmd
internal
api
Package api the public APIs for both the HTTP and the WS endpoints.
Package api the public APIs for both the HTTP and the WS endpoints.
frontend
Package frontend contains the HTTP endpoints for delivering the official web client.
Package frontend contains the HTTP endpoints for delivering the official web client.
sanitize
Package sanitize is used for cleaning up text.
Package sanitize is used for cleaning up text.
state
Package state provides the application state.
Package state provides the application state.
translations
Package translations introduces a simple localization layer that can be used by a templating engine.
Package translations introduces a simple localization layer that can be used by a templating engine.
tools

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL