DEV Community: awsmfoss

🐎 Raider: the self-hostable affiliates dashboard

awsmfoss — Thu, 25 Jan 2024 13:25:39 +0000

Self-hosted software is awesome. If you're running a business and have to manage an Affiliate program, you'd probably love to know about raider. It's a self-hosted piece of Rust code that helps you do just that.

This is a pretty niche piece of software (how many people do you know run Affiliate programs), but if you need just this, this is a pretty awesome F/OSS project to do it with.

The project is written in Rust so it's easy to deploy and has some of the most obviously correct code you can find (granted you can get over the hurdle of learning Rust).

If you've go time to kick the tires, check it out!

This post was originally posted on Awesome F/OSS

🔪 Blades: the static site generator

awsmfoss — Sun, 30 Jul 2023 09:11:07 +0000

If you're looking for a new static site generator (done with Hugo/Jekyll/etc?), check out Blades is an ultra-simple static site generator that creates HTML files from provided content utilizing specified templates.

It uses mustache templates, which are super simple/minimal (even if a little old).

And of course, there's the speed -- Blades prides itself on its faster rendering speeds compared Hugo/Jekyll, thanks to its use of zero-copy deserialization and the ramhorns template engine (pure Rust 🦀).

Blades provides a robust plugin system, supporting input, output, transform, and content plugin types. It's super easy to find other plugins since blades maintains a list you can just look through. Also, Blades has a repository of curated Blades themes.

Blades supports some pretty advanced features like image gallery generation and CommonMark markdown with tables and footnotes for content. When a page contains pictures, Blades automatically generates a gallery for them, assigning certain variables to each photo's page. With pagination functionality, it allows users to navigate through the content with ease, and users can use the available variables in the pagination section.

Blades also has the capacity to generate breadcrumbs based on the page path, which helps in creating navigational aids for the users. Alongside, it has the capability to automatically generate sitemap, Atom, and RSS feeds, contributing to a more organized and accessible user interface. Despite its focus on simplicity, Blades manages to deliver a streamlined and efficient solution for static site generation, balancing speed and usability.

This was originally posted on AWSM FOSS

💸 EthicalAds

awsmfoss — Wed, 10 May 2023 03:14:41 +0000

EthicalAds (code) provides a way for developers and other creators of technical content to get paid for content creation, without using privacy invading advertisement tooling.

Except, it actually protects user privacy, especially when compared to other programs like AdSense. Where traditional advertising methods track user data and browsing habits, EthicalAds serves advertisements based on the context of the website or page, ensuring a non-intrusive and privacy-respecting user experience.

It really is that simple, and while you do have to get approved to be a publisher, the process is pretty painless!

The platform's core ethos is to provide relevant and engaging ads without exploiting personal data, addressing the rising demand for data privacy in the digital world.

EthicalAds supports the online ecosystem by sharing a portion of ad revenue with content creators and website owners. This model is particularly beneficial for open-source projects and creators who rely on such revenue streams. The platform also prides itself on its commitment to high-quality ads, avoiding any content that may be misleading, inappropriate, or excessively distracting. With its user-friendly design, easy integration, and detailed yet anonymous analytics, EthicalAds offers a fresh, ethical perspective on digital advertising.

This was originally posted on AWSM FOSS

F/OSS Spotlight: 📑 VuePress

awsmfoss — Mon, 06 Mar 2023 12:11:15 +0000

Building a static site? If you like and work with Vue, you should check out VuePress (code).

While newer tooling like vitepress may get all the "press" lately, VuePress is still a great stable choice for building good looking documentation sites:

One of the best indicators for quality projects is a "why" page, and VuePress documentation describes exactly why you should use it versus other solutions.

If you're impatient and want to get started away:

mkdir vuepress-starter
cd vuepress-starter
pnpm init
pnpm add -D vuepress@next @vuepress/client@next vue
vuepress dev docs

(NOTE: definitely use pnpm so you can dedup packages locally!)

And if you're not impatient, check out the official Getting Started guide.

The ecosystem for VuePress is somewhat smaller than other site generators (for example Gatsby), but they have their own awesome list which is full of goodies.

Vue is worth choosing for it's power and simplicity, and VuePress is the more opinionated static site generator that's built with Vue at the core.

This was originally posted on AWSM FOSS

F/OSS Spotlight: 🔗 Shlink

awsmfoss — Mon, 13 Feb 2023 10:02:59 +0000

Need to post some links in a small amount of space? You're going to want Shlink (code).

Shlink is a F/OSS link shortener with a great featureset, solid UI and good usability.

Shlink has a ton of features:

PHP warriors out there will feel right at home with Shlink, and will be able to navigate the codebase easily.

If you've been looking for a link shortening service but wanted to run it yourself -- Shlink is the perfect service for you.

Running Shlink

Running Shlink is simple since there is an official docker image (with 10MM downloads!), and the docker container has been built in a way that makes it easy to run:

docker run \
    --name my_shlink \
    -p 8080:8080 \
    -e DEFAULT_DOMAIN=your.domain.tld \
    -e IS_HTTPS_ENABLED=true \
    -e GEOLITE_LICENSE_KEY=<license key> \
    shlinkio/shlink:stable

This was originally posted on AWSM FOSS

Photo by Edge2Edge Media on Unsplash

F/OSS Spotlight: 🧑‍💻 Zuul

awsmfoss — Wed, 01 Feb 2023 10:26:38 +0000

Zuul (code) helps your team stop merging broken code -- the best kind of gatekeeping.

In a world where most people use GitHub Actions or GitLab CI (fantastic tools in their own right) and call it a day, there are enlightened beings out there who seek out CI systems that fully gatekeep commits alltogether. That's Zuul.

Zuul is used by huge organizations like Ampere, Redhat, OVHCloud, and OpenStack, and trusted by many more. Zuul even runs on Volvos, according to an article from ZDNet.

What's important is that Zuul gates your codebase, whereas other tools sometimes let faulty commits go through. Unfortunately there's a bit of a name collision with Netflix Zuul gateway service, but that's awesome F/OSS for another day.

If you're ready to give another CI system a try, check out Zuul.

This was originally posted on AWSM FOSS

F/OSS Spotlight: 🦆 DuckDB

awsmfoss — Tue, 24 Jan 2023 15:51:58 +0000

DuckDB (code) is the SQLite of OLAP queries.

That's high praise, since SQLite is the most widely deployed database on the planet, and is legendary for it's stability, performance (in use-cases that fit) and testing.

DuckDB has lots of platform support:

NodeJS
Python
R
Java
Julia
C++

And it's only growing in popularity. Check out the DuckDB documentation for yourself – it's a well-organized read and should make it easy to understand how DuckDB works.

Much like SQLite, DuckDB has an excellent "why DuckDB" page that you should read.

DuckDB is SQL-based so getting started with it is very familiar (if you know SQL of course), so I won't bore you with that, but jump right into the docs on loading data to get a good feel for how to get started.

This was originally posted on AWSM FOSS

FOSS Spotlight: 👻 Ghost

awsmfoss — Tue, 17 Jan 2023 15:51:57 +0000

Ghost (code) is blogging software that rivals Wordpress in it's ease of use – businesses all over the world use Ghost free of charge and also via Ghost's hosted platform Ghost(Pro).

Ghost makes it easy to build blogs, newsletters, landing pages, portfolio pages and more. It's extremely flexible, well known and easy to use:

Ghost provides an alternative to paid services like Substack. In fact, this newsletter itself runs on Ghost – it's great software.

Running Ghost

Ghost has an official docker image (note the "OG" /_/<container> URL!), and is really easy to run, as it defaults to SQLite which is a breeze.

If you want to get started really quickly:

docker run \
  -d \
  -p 3001:2368 \
  -v /path/to/ghost/blog:/var/lib/ghost/content \
  --name ghost \
  ghost:alpine

Make sure to get your content path (and docker volumes) straightened out before expecting that setup to stick around!

For large production sites you're probably going to want to use MySQL rather than SQLite, but for most sites SQLite will probably hold up well also!

This was originally posted on AWSM FOSS (the first edition!)

FOSS Spotlight: 📺 Jellyfin

awsmfoss — Mon, 09 Jan 2023 00:17:47 +0000

Jellyfin is a well known self-hosted media system and server. It looks great, manages your playlists and makes your media available for watching, listening and reading on the go.

Jellyfin (code) makes self-hosted media serving easy. It looks great and manages and serves your media playlist:

Jellyfin is a favorite of self-hosters and people who people with large media libraries that they want to make available on the go.

Jellyfin is available in many different languages and runs on most operating systems (especially when they're equipped with docker) quite easily. There's also extensive documentation to get you started using it.

Running Jellyfin

Jellyfin is quite docker friendly (the container documentation is where you should start), with an official image ready for use:

docker run -d \
   --name jellyfin \
   --user uid:gid \
   --net=host \
   --volume /path/to/config:/config \ # Alternatively --volume jellyfin-config:/config
   --volume /path/to/cache:/cache \ # Alternatively --volume jellyfin-cache:/cache
   --mount type=bind,source=/path/to/media,target=/media \
   --restart=unless-stopped \
   jellyfin/jellyfin

💻 🤯 AuthN with Authentik, keyboard training with rapid_typing, Analytics with Fugu

awsmfoss — Fri, 06 Jan 2023 02:00:11 +0000

There are a lot of awesome free and open source projects out there, and it's my mission to get them to you (and find about more).

Here's a batch we mentioned recently:

🔑 Authentik

Authentik (code) is an Authentication ("AuthN") glue library that makes it easy to improve your security. Whether it's adding SSO in front of some applications, or acting as an OpenID provider, it's a great relatively light-weight alternative to tools like Keycloak that can be quite cumbersome.

⌨️ rapid_typing

rapid_typing is an obscenely simple faster typing application that helps you practice typing. While the project hasn't seen any commits since 2017 and the demo is down (previously hosted on Heroku, likely on the now-removed free tier), but it's worth looking at if you want a bare-bones, minimal self-hosted tool for improving your typing.

🐠 Fugu

Fugu (code) provides simple, privacy-friendly, open source and self-hostable product analytics. While many tools claim to be Google Analytics alternatives, one of the things Fugu really gets right is properly doing "product analytics" – Going beyond simple view tracking to help you figure out how users are using your (web) software.