timedout/hammerhead
timedout/hammerhead
1
6
Fork 1
Code Issues 1 Pull requests Releases Activity Actions
"Sublight thrusters, full power!" | nimble little matrix server you'll only see once https://timedout.codeberg.page/hammerhead/
511 commits 2 branches 0 tags 7.1 MiB
  • Go 98.3%
  • Shell 1.5%
  • Dockerfile 0.2%
Find a file
timedout d2ef1da010
 chore: Update README to reflect new docs
2026-03-09 04:59:02 +00:00
.forgejo/workflows fix(ci): Always re-run CI workflows when their respective workflow files are modified 2026-03-09 04:53:08 +00:00
.idea Rewrite state resolution code, add unit tests, and fix up room creation (#29) 2026-03-05 13:12:20 +01:00
cmd/hammerhead feat(docs): Switch to mdBook, re-write "getting started" guide 2026-03-09 04:10:03 +00:00
dev feat: Support in-band TLS & multiple listeners 2025-12-29 22:34:30 +00:00
docker feat(docs,docker): Add release docker image and some basic documentation 2025-10-22 10:20:50 +01:00
docs fix(docs): Dyslexia strikes again 2026-03-09 04:52:15 +00:00
pkg feat(docs): Switch to mdBook, re-write "getting started" guide 2026-03-09 04:10:03 +00:00
.gitignore feat: Use toml instead of YAML+JSON 2025-12-29 23:01:40 +00:00
.gitmodules feat: add pre-commit configuration and fix code quality issues (#3) 2025-10-20 16:19:06 +02:00
.golangci.yml Rewrite state resolution code, add unit tests, and fix up room creation (#29) 2026-03-05 13:12:20 +01:00
.markdownlint.yaml feat: add pre-commit configuration and fix code quality issues (#3) 2025-10-20 16:19:06 +02:00
.pre-commit-config.yaml chore: Auto-fix some issues during pre-commit 2025-12-11 16:33:16 +00:00
book.toml feat(docs): Switch to mdBook, re-write "getting started" guide 2026-03-09 04:10:03 +00:00
build.sh feat: Add json2toml and yaml2toml commands 2025-12-29 23:45:16 +00:00
go.mod Remove federation (#30) 2026-03-05 14:04:47 +01:00
go.sum Rewrite state resolution code, add unit tests, and fix up room creation (#29) 2026-03-05 13:12:20 +01:00
LICENSE Initial commit 2025-05-21 03:20:20 +01:00
README.md chore: Update README to reflect new docs 2026-03-09 04:59:02 +00:00

README.md

Hammerhead

Sublight thrusters, full power!

Note

Interested in Hammerhead as a project? Join #hammerhead:nexy7574.co.uk to discuss :)

Hammerhead is a small Matrix homeserver written in Go, written from scratch using the mautrix-go SDK.

The original intention for this implementation was for me to do hands-on learning to understand low-level properties of the Matrix protocol, such as the likes of federation, end-to-end encryption, and state resolution. As a result, a somewhat usable server has emerged.

That being said, if you want a proper Matrix server, please consider continuwuity! Hammerhead isn't quite ready yet.

Documentation

See: https://timedout.codeberg.page/hammerhead/

Roadmap?

There isn't really a roadmap as such, but issues and pull requests get triaged into version milestones, which can be read as a sort of roadmap.

If you wish to discuss things related to Hammerhead, please join the Matrix room at #hammerhead:nexy7574.co.uk.