# 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 8
# self = https://watcher.sour.is/conv/wmyb2pq
@prologic Sounds like a good place to start at, but I still can't really imagine how will any of this syncing look when it's finished and how understandable will it be for new users. 🤔
@thecanine Syncing a feed would at first be primarily supported by the yarnc command-line tool and would work very similarly to how git pull and git push work. Essentially we would suck down the feed from your host account on whatever Yarn.social pod you happen to use, consume the local feed file, do some processing, and if there are no conflicts sync back to both. If there are conflicts, get the user to fix them, before syncing back.
@thecanine Syncing a feed would at first be primarily supported by the yarnc command-line tool and would work very similarly to how git pull and git push work. Essentially we would suck down the feed from your host account on whatever Yarn.social pod you happen to use, consume the local feed file, do some processing, and if there are no conflicts sync back to both. If there are conflicts, get the user to fix them, before syncing back.
It's sort of been a long standing wish of mine to allow users to have their own twtxt.txt file on their PC, also have a Yarn.social account on some pod they trust, or their own, whatever. And be able to use whatever client they like and periodically call yranc sync. This gives them the added benefit of being in full control, whilst also benefiting from Yarn.social's features like discoverability, search, mobile app, etc.
It's sort of been a long standing wish of mine to allow users to have their own twtxt.txt file on their PC, also have a Yarn.social account on some pod they trust, or their own, whatever. And be able to use whatever client they like and periodically call yranc sync. This gives them the added benefit of being in full control, whilst also benefiting from Yarn.social's features like discoverability, search, mobile app, etc.
@prologic okay, I REALLY like that idea! The syncing of a local twtxt.txt file that is.