Package: botterino
BotterinoBotterino allows automation of hosting and posting of /r/picturegame coordinates roundsWhen running botterino, if you win a round, your round will automatically be posted.
It will reply with 'x' or '+correct' to any comments on your round automatically, with configurable tolerances.Pre-requisitesAll the files you interact with will live in the botterino-config folder which is located:windows:C:\Users\your username\botterino-configmac:/Users/<your username/botterino-configlinux:~/botterino-configThese files are created for you the first time you run the botYou must havePythoninstalled on your computerIf on windows it is best to install python from themicrosoft storeInstall the botopen a terminal or command prompt window and type the following command:pip install botterinoYou mustcreate a Reddit appand add authentication details inbotterino-config/praw.ini; seesample-praw.ini(on github) for an exampleGive app any name you choose, such as 'botterino'Choose 'script' as app typeFill in 'redirect URI' withhttp://localhost:8080(This is irrelevant unless OAuth2 is used,but it's a required field)Once created, you'll have a 'secret', copy/paste that asclient_secretin botterino-config/praw.iniYou'll also have a less obvious client id, in the top left under the app name and the words 'personal use script' - copy/paste that intoclient_idin praw.iniFill out the rest of 'botterino-config/praw.ini' with your Reddit username/password as well as anything you want foruser_agentUsageadd round(s) in botterino-config/rounds/rounds.yaml. See sample-rounds.yaml on botterino github page for information on round syntax and types of features supported.run withpython -m botterinoUI:The ui can be launched withpython -m botterino.uiThrough the ui you can automatically populate rounds.yaml and start/stop the botNormal hostingRounds are kept in the 'rounds/rounds.yaml' file, see 'sample.yaml' for some examplesStepsAdd round(s) to 'botterino-config/rounds/rounds.yaml'Open a terminal or command prompt and typepython -m botterinoThen all you have to do is win. Until you win, botterino will do nothingWhen you win, the top round in rounds.yaml is posted as soon as you are approved to hostAny new rounds added to 'botterino-config/rounds/rounds.yaml' while the app is running will automatically be added to the queue, no need to restart.
Once a round is complete, it will be moved to 'botterino-config/rounds/archive.yaml'.Live roundsBotterino can be used on a round that is already liveThis is useful for cases whereYou post manually and decide you would like bot to hostBot posts for you but crashes during hosting for some reasonStepsWill use the top round in rounds.yamlurlfield should be omittedRun withpython -m botterino.failureHints:Botterino can schedule hints and post them autmoatically.
If the filebotterino-config/hints.txtcontains content,
its content will be posted to the currently hosted round as a hint
at the time specified by the user, and then the file is cleared.
Default hint times can be specified
inbotterino-config/config.ini.
The default value ishints=[25,45].
The default hint list can be overridden per round by adding the fieldhints: [10, 20,30]as a new field in rounds.yaml.
Hint times are in minutes and are integers.
Hints at hour boundaries do not need to be specified. If the
hint file contains text it will be posted automatically at 60,120,180 etc...MiscCustomizeOptions such as correct message and incorrect message can be customized in botterino-config/config.iniUpdateUpdate this botterino withpip install --upgrade botterinoIssuesBot does not run, crash message shows 403 error, everything in praw.ini looks correcttry a different user agentColors on windowsThis botterino uses colorful output. If you see strange output like this on windowsthen downloadWindows terminalfrom the Microsoft store.