tkr: A barebones status feed for personal websites - Update: v1.0.0 released!

oooh, i see. I see two issues. The first I can fix quickly - it looks like I didn’t include the root-level .htaccess file in the .zip/.tgz archive. That’s why you’re getting the directory listing instead of the setup page. Thought I was testing for that.

The second is a version issue. I’m using some php 8+ syntax that breaks under php 7.4. I’ll take a look and see how much php 8+ syntax is there and what it would take to revise it for php 7.4.

The directory access is inconsequential, I just wanted to know if the fatal issue I tried to talk about was related to a version difference matter and if the #!/usr/bin/env php line was intended to be in that php file or not.

Since it’s a version issue I’ll…. see i I can update or not x_x (I have a whole OS to update that I’ve been afraid to do)

Oh, no - if the .htaccess file had been in the root directory like it should have been, then your browser would have tried to do the web setup automatically. You caught a bug in my build process for me, and now I see where I went wrong before.

The 1.0.6 version includes the .htaccess file, but it still won’t work on php 7.4. I started trying to see if I could do a quick fix, but a lot of things break.

I hate to send you down an OS upgrade rabbithole just for this. I can work on a 7.4 version, it’ll just take me some time.

tgz
zip

For security reasons, I really do need to do the upgrade, I’ve just been dragging my heels because I’m afraid of breaking stuff because I have no idea what changes between versions and haven’t found a friendly guide that itemizes that. (this is ultimately why I haven’t really tested it, earlier)

I decided to try a truly minimal version of tkr and I think I have something working. It’s called rsrss because I like bad inside jokes (really simple really simple syndication). It can be installed from this zip file.

It has 8 files including the README. The only requirement is PHP support. All data is written to text files. Posts are written to a JSON file (posts.json), and the RSS feed is written to an XML file (rss.xml).

No LLM help this time. This is all stuff I either wrote or adapted from things that @ShannonKay and @rmf have done.

Installation instructions are in the zip file README, but basically:

  • unzip the file
  • Copy it to your web server under /feed (the zip extracts to feed/)
  • Edit settings.php to change the password, site url, and description
    • (The RSS feed needs the URL and description to conform to the spec)
  • Make posts.json and rss.xml writable.
    chmod 0666 posts.json
    chmod 0666 rss.xml
    
  • Browse to https://your-site.com/feed

The page should come up. To make a new post, click “Post an update”, enter your post and password, and click the Post button.

The RSS feed is at https://your-site.com/feed/rss.xml. It’s linked in the main page, so rss readers should be able to find it (confirmed with feedbro).

I’ve been testing it in PHP 7.4 and 8.2, but there’s nothing fancy about the code, so it should probably work with earlier versions of PHP.

I think this is more along the lines of other self-hosted personal web tools. If nothing else, it should be easier to install than tkr. My hope is that it’s truly an accessible RSS feed generator. I’ll put together a page for it on my projects site soon so it has an easier to find home.

If you’re curious, you can check it out here: https://playground.subcultureofone.org/feed/

The password is 32bitcafe

I’ve tried it out under apache and nginx and it seems to “just work” if you copy it to /feed and point your browser to it. But I’ve stripped away all the testing and validation in the name of simplicity, so I may have missed something. I hope it’s simple enough that there’s not much to miss, though.

I do have more ideas for tkr, so I’m going to keep working on that, but I wanted to also provide something lighter weight once I saw other examples.

[EDIT] And I haven’t forgotten about improving the tkr docs. I’m working on that, but decided to do this first.

I’ve finished the docs sites. There’s one for each project.

Now that these pages are up, I’ll post future updates there instead of continuing to bump this thread. There’s a projects RSS feed at Subculture of one projects RSS Feed. I’ll update that when there’s significant news (new features and that sort of thing) if you’d like to follow updates that way. This will mostly be for tkr. I think rsrss pretty much is what it needs to be.

If anyone tries either of these again and runs into trouble, feel free to post in this thread. You can also email me at greg@subcultureofone.org.

Thanks again to all of you for helping me out and following along.