{"id":21522724,"url":"https://github.com/poeschl/slowwave","last_synced_at":"2025-04-09T22:41:22.050Z","repository":{"id":158004789,"uuid":"629398455","full_name":"Poeschl/slowwave","owner":"Poeschl","description":"A Pixelflut server with several things to make Pixelflut interesting again.","archived":false,"fork":false,"pushed_at":"2024-11-01T03:12:47.000Z","size":204,"stargazers_count":2,"open_issues_count":4,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T00:38:17.422Z","etag":null,"topics":["pixelflut-server"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Poeschl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://www.buymeacoffee.com/poeschl"}},"created_at":"2023-04-18T08:28:18.000Z","updated_at":"2024-08-28T21:00:56.000Z","dependencies_parsed_at":"2024-05-01T05:23:54.502Z","dependency_job_id":"60039165-ffb8-44f2-a78d-6ecca0cecebd","html_url":"https://github.com/Poeschl/slowwave","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/Poeschl%2Fslowwave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Poeschl%2Fslowwave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Poeschl%2Fslowwave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Poeschl%2Fslowwave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Poeschl","download_url":"https://codeload.github.com/Poeschl/slowwave/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248124848,"owners_count":21051757,"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":["pixelflut-server"],"created_at":"2024-11-24T01:11:33.337Z","updated_at":"2025-04-09T22:41:22.033Z","avatar_url":"https://github.com/Poeschl.png","language":"Kotlin","funding_links":["https://www.buymeacoffee.com/poeschl"],"categories":[],"sub_categories":[],"readme":"# Slowwave\n\n```text\n       _.====.._\n     ,:._       ~-_\n         `\\        ~-_\n           |          `.\n         ,/             ~-_\n-..__..-''                ~~--..__...-\n```\n\nA slow Pixelflut server with some other benefits.\n\n## Features\n\n* Not high-performance\n* Default [Pixelflut](https://github.com/defnull/pixelflut) commands (`HELP`, `SIZE`, `PX`)\n* `OFFSET` command for setting an offset for all `PX` commands on this connection.\n* Website at http://localhost:8080 for image output and some stats\n* The `TOKEN` command. For more see below.\n\nMore coming soon...\n\n### The `TOKEN` command\n\nWhen the `TOKEN` command is enabled with commandline flag `--token` every `PX` command requires a token to paint.\nOne token is valid for the ip the request is sent from and will last a specific amount of `PX` calls.\nThe usage count can be changed with the `--useCountPerToken \u003cvalue\u003e` commandline parameter, per default its `100` calls.\n\nTo retrieve a token the `TOKEN` command can be called. This command is rate-limited to 1 call per second!\nIn combination with the use count a rate limit for painting actions per host is established.\n\nAll `PX` painting commands must specify an additional parameter, which is the token.\n\nAn example flow:\n\n```text\n-\u003e PX 1 1 ff0000\n\u003c- ERR Invalid Token\n\n-\u003e TOKEN\n\u003c- TOKEN a466bb98-492e-4770-a772-b0b477bf26a7 100\n#         /\\                                   /\\\n#         ||                                   ||        \n#      The token                      Remaining usage count\n\n-\u003e PX 1 1 ff0000 a466bb98-492e-4770-a772-b0b477bf26a7\n\u003c- \n```\n\n## Running\n\nThe recommended way to run slowwave is a containerized deployment.\nPre-build images can be found in the packages of this project.\nFor an easy start there is a `docker-compose.yaml` in the repository.\n\nThe docker images have versioned tags.\nBut the `latest` tag points to the latest dev version (this will be the bloody edge)!\n\n## Development\n\nTo test the local dev build of slowwave a pixelpawner docker-compose can be found in the `test` folder.\n\n### Release\n\nFor a release execute `./gradlew release` locally, it will create a release with version number.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpoeschl%2Fslowwave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpoeschl%2Fslowwave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpoeschl%2Fslowwave/lists"}