It's finally done! #ocular can now automatically post images to your mastodon account - huzzah!

https://nchrs.xyz/ocular.html

Host your own tiny static image feed, join the webring and share images #smallweb style!

Boosts appreciated. 

@rostiger Congrats on this!

Let's say I just wanted to create a series of image galleries, and maybe didn't care about a comment system, would okular still be a good choice?

Also, a great next step would be to host a web-based tutorial (if there is one, i didn't immediately find it).

@exquisitecorp Sure! ocular has no comment system per se, uploading to Mastodon (which is completely optional) serves that function.

You can have multiple galleries by creating multiple project directories where the script lives in each of them. You can't build different galleries with one command though, you would need to build each gallery separately and manually.

The setup and usage instructions currently live in the readme in the repo. Is there anything you are missing? Or do you think better communication on where to find the instructions would be enough?

@rostiger thanks, that's helpful info re multiple galleries.

In terms of install and running okular, WHERE do i put my photos? does okular resize them? do i need to name them anything in particular? how do i add captions?

i'd add the output of okular -h to your README. on looking at the script it seems like maybe you use okular -a and then add a single image at a time? i'm not certain.

i guess i was expecting i'd drop images in a folder, have a text file with captions or titles, and then run your script. i'm thinking that assumption is incorrect.

@rostiger basically, i had assumed it was a static site generator for image galleries, something like faircamp-ish. but it sounds like you individually add photos.

@exquisitecorp Ah, that's valuable feedback, thank you! I need to clarify the intention of ocular: it's more of a smallweb replacement for platforms like instagram or pixelfed. Unlike many gallery systems out there where you take a bunch of pictures and it creates a gallery, ocular is for sharing pictures one by one, creating a feed of images. Instead of uploading an image to a platform, you add the image locally, build the gallery and upload the whole thing. With each upload, the feeds from the webring are pulled and integrated in the gallery.

This is also why you don't put any images anywhere than were they already are on your computer. ocular will create a database with the absolute paths to the image, which can be anywhere on your computer. It creates differently sized previews and stores them inside its project directory, but the originals will stay untouched.

@exquisitecorp I updated the readme for more clarity, I hope this helps:

https://codeberg.org/rostiger/ocular

ocular

A small image gallery generator written in Lua.

Codeberg.org
@rostiger Excellent! Much clearer!