https://github.com/codahale/yellhole
Where else you gonna scream?
https://github.com/codahale/yellhole
Last synced: 2 months ago
JSON representation
Where else you gonna scream?
- Host: GitHub
- URL: https://github.com/codahale/yellhole
- Owner: codahale
- License: agpl-3.0
- Created: 2022-11-04T02:49:56.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-08-02T17:03:58.000Z (8 months ago)
- Last Synced: 2025-08-02T19:31:20.370Z (8 months ago)
- Language: Rust
- Homepage:
- Size: 2.08 MB
- Stars: 19
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Yellhole
## A Hole To Yell In
Yellhole is a lightweight tumblelog which can run on e.g. [fly.io](https://fly.io) for cheap.
## Features
* Runs on a single node. Use a CDN if you're popular.
* All data is stored in a single directory.
* Simple single-user registration/login with Passkeys.
* Simple mobile-friendly interface.
* Write posts in Markdown.
* Upload images of any format (including HEIC), it converts them to WebP.
* Download images via URL, same thing.
* Simple image gallery makes it easy to post images.
* No titles, contents addressable by ID, contents sorted by time.
* Atom feed so your friends can watch.
## Installation
```shell
cargo install --locked yellhole
```
(I mean, at some point you might be able to do this but I haven't packaged it yet.)
Requires SQLite and a TLS stack as build dependencies.
Requires ImageMagick as system dependency (specifically, `magick` must be in `$PATH`).
## Operation
See `Dockerfile` for packaging example. See `fly.toml` for deployment example.
## Shitposting
1. Get Yellhole running somewhere.
2. Go to `/register` and register a Passkey.
3. Log in with your Passkey and go to `/admin/new`.
4. Shitpost.
5. Go to `/` and admire your work.
## License
Copyright © 2022 Coda Hale
Distributed under the Affero General Public License (v3 or later).