# I am the Watcher. I am your guide through this vast new twtiverse.
#
# Usage:
# https://watcher.sour.is/api/plain/users View list of users and latest twt date.
# https://watcher.sour.is/api/plain/twt View all twts.
# https://watcher.sour.is/api/plain/mentions?uri=:uri View all mentions for uri.
# https://watcher.sour.is/api/plain/conv/:hash View all twts for a conversation subject.
#
# Options:
# uri Filter to show a specific users twts.
# offset Start index for quey.
# limit Count of items to return (going back in time).
#
# twt range = 1 14
# self = https://watcher.sour.is/conv/bcqpeuq
@prologic Haha thanks. I'm not normally big on microblogging but thought I'd give it a try. If I get into it I'd hope to end up running my own instance / something else compatible (probably single-user so maybe my own instance of Yarn.social itself is overkill??)
@caesar Nope many folks do in fact run single-use pods (as we call them) so not overkill at all! 👌
@caesar Nope many folks do in fact run single-use pods (as we call them) so not overkill at all! 👌
@prologic Ah that's good to know. I have to look more into how discovery works etc, but is there any issue with using a root domain for my username (handle / whatever you call it here?) but hosting Yarn.social on a subdomain?
So my username might be @caesar@example.com but Yarn.social would be at something like yarn.example.com so that I could host a normal website at example.com. Does that make sense?
Maybe something as simple as an HTTP redirect from example.com/twtxt.txt to yarn.example.com/users/caesar/twtxt.txt? 🤔 But I'm sure I'm not the first to want to do this so is there a 'canonical way' to do it?
It does make sense and there's a couple of ways you can do this 👌I shall respond in more detail a bit later when I can. But suffice to say a redirect will work fine, you may need or want to customize your Fred's preamble (the comments / metadata at the top) and finally supporting a proper first-class -S / --single-user mode 👌 Maybe you can help me build this out? 🤔
It does make sense and there's a couple of ways you can do this 👌I shall respond in more detail a bit later when I can. But suffice to say a redirect will work fine, you may need or want to customize your Fred's preamble (the comments / metadata at the top) and finally supporting a proper first-class -S / --single-user mode 👌 Maybe you can help me build this out? 🤔
Hmm that's a good point about potentially wanting to customise the preamble. Does Yarn work as a frontend to a static twtxt.txt file or is it keeping everything in the DB (I see it uses one) and generating the twtxt files on-the-fly? In the former case, I imagine it wouldn't be hard to add a config option to use a different path? Or maybe I'm talking nonsense because I haven't looked into how this all works yet...
Yes I'd be happy to help build it out, I have next to no experience with Go, but that's a plus for me because it's an excuse to learn it ;-) Would you rather we discussed over on Gitea?
@caesar Don't mind either way but we do have to flesh out how single-user mode should work 👌
@caesar Don't mind either way but we do have to flesh out how single-user mode should work 👌
@prologic I'll put some thought into what I think would be ideal for my use case (I'm not totally sure yet) and open an issue on Gitea.