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.

Feel free to play on scribblers.fly.dev. Note that the instance may not respond instantly, as it automatically shuts down if no traffic is received.

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

Available settings:

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

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.

Dependencies:

• go version 1.21 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.

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

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

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

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

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.

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

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.

• Logo - All rights reserved, excluded from BSD-3 licensing
• Background - All rights reserved, excluded from BSD-3 licensing
• Favicon - All rights reserved, excluded from BSD-3 licensing
• Rubber Icon - Made by Pixel Buddha from flaticon.com
• Fill Bucket Icon - Made by inipagistudio from flaticon.com
• Kicking Icon - Kicking Icon #309402
• Sound / No sound Icon - Made by Viktor Erikson (If this is you or you know who this is, send me a link to that persons Homepage)
• Profile Icon - Made by kumakamu
• Help Icon - Made by Ionicons
• Fullscreen Icon - Made by Github
• Pencil Icon
• Checkmark Icon
• Fill Icon
• Trash Icon - Made by Yannick Lung
• Undo Icon - Made by Ivan Boyko
• Alarmclock Icon - Made by Kit of Parts
• https://www.iconfinder.com/icons/808399/load_turn_turnaround_icon TODO