slackifpy | Python script that bridges between Slack and IF

slackifpy is a Python library. slackifpy has no bugs, it has no vulnerabilities, it has a Permissive License and it has low support. However slackifpy build file is not available. You can download it from GitHub.

Note: I've moved away from Slack and will no longer be able to test this script out (not that I knew what I was doing in the first place, ha). Some help is available at the original forum thread if you run into issues. This (slackifpy) is a python script that interfaces between Slack and an interactive fiction interpreter. This allows you to play parser-based interactive fiction games in a Slack channel with anyone else who is a member of that channel. It requires Python and an internet connection but does not require a web server (it uses RTM, not webhooks). Download the repo. I suggest using a VM running linux as host. Install slack client for python. Download the games you want to play. Get the source for and compile the appropriate interpreter(s) with glk. Update gamedb.py with game info. Change the configuration options in the main script as the comments direct, using your channel id and your bot or user slack token. The bot wil report in once it is active; use "@ifbot help" in Slack to get a list of commands. This is not a hard or complicated process, but it requires multiple steps and there's potential for confusion at nearly every one of them. Treat each step as a separate task that might require extensive googling. Don't be afraid to google for tutorials or error messages at each step. If you choose Debian, for ease of use, choose "graphical install" and pick "lxde" as your interface (unless you have another preference). Be sure to check the box to include the system tools. Once you're booted up, set up VM's Guest Additions and mount a shared directory with your host system so you can easily pass files back and forth. You don't need all the interpreters, just the ones that handle the games you want to run. IMPORTANT: You need to compile from the operating system you will ultimately use to run slackifpy. So if you are using a Debian VM, you would use the Debian terminal to do the rest of this step. If any of these steps fail at any point, you're probably missing dependencies. Read the error message and google it. In Debian using LXDE, if you use the file manager, you can hit F4 to open a terminal in the current file folder. Otherwise, you'll need to use "cd" and "ls" to navigate. Every interpreter has notes and install instructions -- the steps I list here worked for me but there are a lot of variables. BOCFEL Bocfel should cover a pretty wide number of games (including zblorb). To compile, download and unpack the archive and do the same for cheapglk. READ THE README. READ THE BUILDING FILE (this has an overview on the entire process that can be applied generally to any of the other interpreters). To summarize, set the required settings. Move the cheapglk folder to the bocfel folder and compile it. Then open a terminal window in the bocfel directory and type "make" and wait for it to finish. Then copy the new bocfel file to the "terps" subfolder. FROTZ: You ultimately want to compile "dfrotz", which outputs text to the terminal instead of to a fancy window. First, grab the zip from github. Unpack the zip. READ THE README. Open a terminal in the frotz-master directory you just unpacked. Type "make dumb" and wait for it to finish. You should now have a file named "dfrotz" that wasn't there before. Copy it to the "terps" subfolder. GLULXE: Compile glulxe with cheapglk; this is the default so it's easy. READ THE README. Download both zips and extract. Rename cheapglk-master to cheapglk. Open cheapglk in the terminal and type "./make", then repeat for the glulxe folder. FROBTADS: This one can be tricky because of dependencies. Download the zip and extract. READ THE README. Go to the FrobTads directory and open a terminal. At the terminal, type "./bootstrap", then "./configure", and finally "make". Be prepared for it to take awhile.