Go to file
Ted Unangst 5b88d4d183 a few improvements to docs 2021-01-17 19:28:39 -05:00
docs a few improvements to docs 2021-01-17 19:28:39 -05:00
toys just sleep if we get error 502 2020-09-25 18:46:15 -04:00
views rework how sub/unsub works, and add delete to honkers 2020-11-25 22:03:46 -05:00
.hgignore Add support for [^\n] meme files & hgignore 2019-11-26 10:35:10 +00:00
.hgtags Added tag v0.9.5 for changeset 3ece33fb7780 2020-12-10 01:17:08 -05:00
LICENSE more complete and explicit license information 2019-08-18 18:21:07 -04:00
Makefile clarify build requirements and add a check script for common errors 2020-10-01 21:58:50 -04:00
README clarify build requirements and add a check script for common errors 2020-10-01 21:58:50 -04:00
activity.go fix Update processing broken in activity rework some time ago 2021-01-05 16:07:49 -05:00
admin.go custom lingo for those who don't like honking 2020-09-25 22:37:28 -04:00
avatar.go promote flag: feature out of the experimental sandbox 2020-07-07 20:34:59 -04:00
backend.go don't panic for now if we lose backend 2020-04-30 12:03:57 -04:00
backupdb.go need all the params 2020-09-30 15:27:22 -04:00
bloat.go promote flag: feature out of the experimental sandbox 2020-07-07 20:34:59 -04:00
database.go rework how sub/unsub works, and add delete to honkers 2020-11-25 22:03:46 -05:00
deliverator.go don't need to retry low prio communications 2020-09-29 21:16:07 -04:00
fun.go switch to only generating xid for donks where needed 2020-09-30 11:35:18 -04:00
genschemago.sh decouple files from "." and allow data and view to live anywhere 2019-11-01 15:48:31 -04:00
go.mod a whole mess of mod updates 2020-11-10 23:18:33 -05:00
go.sum a whole mess of mod updates 2020-11-10 23:18:33 -05:00
hfcs.go i tried parsing regex and now i have three problems. 2021-01-17 19:05:57 -05:00
honk.go make the ping command easier to use 2020-11-11 14:44:51 -05:00
hoot.go fix hoot to work with twitter's crap 2020-12-22 13:04:04 -05:00
hoot_test.go make the hoot code amenable to testing 2019-10-31 00:00:31 -04:00
import.go fix mastodon import to work with new format. 2021-01-17 19:01:54 -05:00
markitzero.go move hashtag to mz module 2020-07-20 23:00:36 -04:00
preflight.sh clarify build requirements and add a check script for common errors 2020-10-01 21:58:50 -04:00
schema.go prepare to save id for follow requests 2020-08-10 15:15:11 -04:00
schema.sql prepare to save id for follow requests 2020-08-10 15:15:11 -04:00
sensors.go add sensors to the about page 2019-11-08 19:11:37 -05:00
skulduggery.go disable some more cache control in debug mode 2019-12-04 00:44:45 -05:00
unveil.go use separate backend hooks with tighter pledge 2019-11-27 15:58:41 -05:00
upgradedb.go dedupe blob file data 2020-09-30 15:20:40 -04:00
util.go fix honk init user creation 2020-12-10 01:16:46 -05:00
web.go rework how sub/unsub works, and add delete to honkers 2020-11-25 22:03:46 -05:00

README

honk

-- features

Take control of your honks and join the federation.
An ActivityPub server with minimal setup and support costs.
Spend more time using the software and less time operating it.

No attention mining.
No likes, no faves, no polls, no stars, no claps, no counts.

Purple color scheme. Custom emus. Memes too.
Avatars automatically assigned by the NSA.

The button to submit a new honk says "it's gonna be honked".

The honk mission is to work well if it's what you want.
This does not imply the goal is to be what you want.

-- build

It should be sufficient to type make after unpacking a release.
You'll need a go compiler version 1.13 or later. And libsqlite3.

Even on a fast machine, building from source can take several seconds.

Development sources: hg clone https://humungus.tedunangst.com/r/honk

-- setup

honk expects to be fronted by a TLS terminating reverse proxy.

First, create the database. This will ask four questions.
./honk init
username: (the username you want)
password: (the password you want)
listenaddr: (tcp or unix: localhost:31337, /var/www/honk.sock, etc.)
servername: (public DNS name: honk.example.com)

Then run honk.
./honk

-- upgrade

cp honk.db backup.db
./honk upgrade
./honk

-- documentation

There is a more complete incomplete manual. This is just the README.

-- guidelines

One honk per day, or call it an "eighth-tenth" honk.
If your honk frequency changes, so will the number of honks.

The honk should be short, but not so short that you cannot identify it.

The honk is an animal sign of respect and should be accompanied by a
friendly greeting or a nod.

The honk should be done from a seat and in a safe area.

It is considered rude to make noise in a place of business.

The honk may be made on public property only when the person doing
the honk has the permission of the owner of that property.

-- disclaimer

Do not use honk to contact emergency services.