Mirror of Aperture
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Aaron Parecki 06929ae5f0
Merge pull request #109 from martymcguire/patch-1
2 weeks ago
.github Create FUNDING.yml 2 years ago
aperture default APP_DEBUG to false in .env.example 2 weeks ago
.gitignore new Laravel 5.5 app with IndieAuth login and Bulma css 4 years ago
CONTRIBUTING.md expand readme 3 years ago
LICENSE add license/contributing 3 years ago
README.md expand readme 3 years ago



Aperture is a Microsub server.

It is currently in beta, and although has been pretty stable for the last several months. You can try out the hosted service at aperture.p3k.io, which keeps data for 7 days, or you can host your own copy to customize it.


By default, new user accounts are not created automatically. You will need to first create a user before you can log in.

From the command line, run this command, passing your home page URL as the argument:

php artisan create:user https://example.com/

You will need to have a token endpoint set up already in order for Aperture to know how to verify access tokens it receives in Microsub requests. If there is no token endpoint found at that URL, user account creation will fail.

You can enable a config option to allow anyone to sign in to your instance. Set PUBLIC_ACCESS=true in .env.


Aperture relies on a few external services to work.

Watchtower handles actually subscribing to feeds and delivering content to Aperture. Aperture is only responsible for parsing the content, but contains no feed polling/fetching logic.

Aperture uses an image proxy to rewrite all image URLs as https URLs. It expects to use a service that matches GitHub's camo API. You can use either camo itself, or an API-compatible project such as go-camo. You'll need to define the base URL IMG_PROXY_URL and the signing secret IMG_PROXY_KEY in the .env file.


Aperture logo by Gregor Cresnar from the Noun Project.


Copyright 2018 by Aaron parecki.

Available under the Apache 2.0 license.