Go to file
Ted Unangst 829c0af097 new sample colors 2023-08-09 15:44:54 -04:00
docs new sample colors 2023-08-09 15:44:54 -04:00
memes add a sample meme 2023-08-06 02:19:56 -04:00
toys clean up the dust 2023-03-17 10:45:25 -04:00
views new sample colors 2023-08-09 15:44:54 -04:00
.hgignore update ignore file 2023-08-07 02:28:49 -04:00
.hgtags Added tag v0.9.91 for changeset d7c3a01e7aae 2023-03-17 14:29:34 -04:00
LICENSE more complete and explicit license information 2019-08-18 18:21:07 -04:00
Makefile CGO is required, and the compiler error without is confusing 2023-07-13 02:27:53 -04:00
README specify 127.0.0.1 in readme. some people still trying to use ipv6. 2022-07-23 17:49:04 -04:00
activity.go repair loss of bonker information in last refactor 2023-08-06 03:04:37 -04:00
admin.go go vet claims we need a buffered chan for signal 2023-07-02 14:08:26 -04:00
avatar.go an attempt at opengraph 2023-06-13 14:58:35 -04:00
backend.go don't report errors when the backend is expected to die 2023-06-21 01:08:13 -04:00
backupdb.go flexible logging 2022-02-06 00:42:13 -05:00
bloat.go qotd 2023-08-08 16:17:47 -04:00
database.go unusued range var 2023-08-02 23:34:24 -04:00
deliverator.go let's just say http 400 is okie dokie 2023-07-27 20:51:19 -04:00
fun.go need to demasto the mention 2023-07-31 20:46:43 -04:00
go.mod webs bump for html fix 2023-08-07 17:28:14 -04:00
go.sum webs bump for html fix 2023-08-07 17:28:14 -04:00
hfcs.go less aggressive rewrite filter rewriting 2023-06-17 20:26:38 -04:00
honk.go split main into a new file, add build info 2023-08-07 02:27:25 -04:00
hoot.go remove very old dead code which is confusing 2023-02-19 19:45:09 -05:00
hoot_test.go need logger to not crash 2022-07-03 16:07:23 -04:00
import.go update twitter import again, from tom 2023-08-04 13:08:15 -04:00
main.go do not run honk as root 2023-08-07 13:58:24 -04:00
preflight.sh revise go version check 2022-05-31 02:45:51 -04:00
schema.sql create a plain column and use that for search 2023-07-31 19:46:55 -04:00
sensors.go split main into a new file, add build info 2023-08-07 02:27:25 -04:00
skulduggery.go disable some more cache control in debug mode 2019-12-04 00:44:45 -05:00
unveil.go don't need fmt 2023-07-10 00:16:42 -04:00
upgradedb.go upgrade to backfill the plain text column 2023-07-31 20:36:15 -04:00
util.go go vet claims we need a buffered chan for signal 2023-07-02 14:08:26 -04:00
web.go qotd 2023-08-08 16:17:47 -04: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.16 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: 127.0.0.1:31337, /var/www/honk.sock, etc.)
servername: (public DNS name: honk.example.com)

Then run honk.
./honk

-- upgrade

old-honk backup `date +backup-%F`
./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.