Arivertisements
An open source alternative to Johnvertisements inspired by john.citrons.xyz
!
# What's This?
This project was inspired by Johnvertisements from citrons.xyz
, motivated by several significant concerns around security, privacy, transparency, and performance. Johnvertisements use unrestricted iframes embedded on every page - a technique that introduces security risks and privacy concerns. Furthermore, Johnvertisements is neither open source nor verifiable, and its performance is questionable at times.
This is why Arivertisements were born :D I aim to improve on silly "advertisements".
The general goal of this project is to create a self-hostable, open source alternative that presents "advertisements" to users as sort of a rantomised webring, completely for free :)
But enough yap. Further see how to embed an Arivertisement on your website, how to contribute your own Arivertisement, our testimonials, or the leaderboard!
# Embedding an Arivertisement
To embed an Arivertisement, simply add an iframe pointing to https://ad.ari.lt/ads/embed
, optionally with your URL to be listed on the public leaderboard https://ad.ari.lt/ads/embed?from=example.com
(or https://example.com/
).
The from
parameter is optional and can be removed if you want to simply have silly images on your website without identifying your website or getting listed on the leaderboard.
Here's a helper script to generate secure HTML to embed it:
Note that if you want to use a strict CSP, you may want to move style
into its own element (with a nonce
) or a relevant stylesheet.
On average, a new Arivertisment will load every 5 minutes (due to caching rules, if you think this should be lower or higher, drop me an email!), and the Arivertisement images are cached for 30 days.
# Arivertising Yourself
Everyone is encouraged to Arivertise. It is the best way to Arivertise. You are not required to have an Arivertisment embed on your website, but it is highly recommended. Either way, to Arivertise you have three options:
-
Contribute directly to the Arivertisements repository with a pull request (requires an account).
Expand for a note regarding repository size
- Please don't forget to optimise your image using online (e.g, "PNG optimiser online") or local tools such as
optipng -o7 -strip all my-ad.png
for PNGs,jpegoptim --strip-all my-ad.jpg
for JPEGs, andgifsicle --batch --optimize=3 --lossy=100 --colors=40 my-ad.gif
for GIFs. This helps to keep the respotory size small.
- Please don't forget to optimise your image using online (e.g, "PNG optimiser online") or local tools such as
-
Clone the Arivertisements repository on another forge (e.g., GitHub) and send an email to ari@ari.lt (decentralised git)
Expand for a guide for GitHub
- Create an empty GitHub repository on your account called 'arivertisements'
- Run
git clone https://git.ari.lt/ari.lt/arivertisements --depth 1
(you can leave out the--depth 1
if you want to keep the whole commit history, but due to the repository size, it is recommended to only shallow clone) - Run
git remote set-url origin ssh://git@github.com:YourUsername/arivertisements.git
(or the https version) -
Make your changes (based on
CONTRIBUTING.md
), commit (signed +Signed-off-by
), and push- Please don't forget to optimise your image using online (e.g, "PNG optimiser online") or local tools such as
optipng -o7 -strip all my-ad.png
for PNGs,jpegoptim --strip-all my-ad.jpg
for JPEGs, andgifsicle --batch --optimize=3 --lossy=100 --colors=40 my-ad.gif
for GIFs. This helps to keep the respotory size small.
- Please don't forget to optimise your image using online (e.g, "PNG optimiser online") or local tools such as
- Notify me on e-mail, after which I will manually
git pull
your repository to the upstream.
-
E-Mail ari@ari.lt your metadata file and image, while giving explicit permission to forge a commit as you (direct contribution).
Expand for a guide on how to do that
- Create your image which meets the contribution guidelines at
CONTRIBUTING.md
in the Arivertisements repository (legal, moral, 722x84, common format, up to 256 KiB, optimised). - Optimise your image using online (e.g, "PNG optimiser online") or local tools such as
optipng -o7 -strip all my-ad.png
for PNGs,jpegoptim --strip-all my-ad.jpg
for JPEGs, andgifsicle --batch --optimize=3 --lossy=100 --colors=40 my-ad.gif
for GIFs. - Write your metadata file named the same as your image just a
.txt
based on the same guidelines: - Notify me on e-mail, attaching both the image and your metadata file, with explicit forging consent:
I am okay with you forging a git commit for me based on the provided metadata file and I affirm the contribution rules and conditions at https://git.ari.lt/ari.lt/arivertisements (CONTRIBUTING.md file)
The rules and conditions being your image and metadata meets requirements, is your own original and verifiable work, and you explicitly license it under the CC-BY-NC-SA 4.0 license for use in Arivertisements.
- Create your image which meets the contribution guidelines at
# Testimonials
- "I got my first email from a person who came accross the site [shittyweb.org] - they found it through the 'free money' Arivertisment" - Nathan Smith (shittyweb.org), a happy Arivertiser
- "Nathan from ad.ari.lt is so silly!" - Kali (dystopia.zip), silly and goofy Arivertiser
- "i farted" - jjj333_p (pain.agency), ewww stinky!!! Arivertiser
- Submit yours through email at ari@ari.lt!
# Leaderboard of Top Arivertisers
General statistics:
- Total Arivertisements delivered: 7752
- Total Arivertisements in rotation: 16 +1 for yours...? We're waiting!
- Total sites Arivertising: 18 nudge nudge
Leaderboard:
Domain/Website | Count |
---|---|
ari.lt | 3500 |
shittyweb.org | 1351 |
aria.coffee | 752 |
https://pain.agency | 392 |
Note: To be listed you must render at least 256 Arivertisements and have a valid A
record at all times. To get delisted, email ari@ari.lt.