LOMC Installation Guide

LOMC (Low Orbit Meme Cannon) is a Python script that will randomly combine pre-defined statuses and memes into tweets, periodically tweeting them for you.

Statuses can be written into separate .txt files and held in a folder called "statuses". Memes can be dumped into a folder called "memes". LOMC will then search these folders periodically, randomly generate tweet combinations, and then tweet them. Currently it tweets once every 333 seconds, this can be adjusted but please be aware of Twitter's API  limitations before adjusting the set time delay value (https://support.twitter.com/articles/15364).

You will need to install Python on your system and configure LOMC to connect to your twitter account, instructions below.

1. Install Python
2. Download Script
3. Install TwitterAPI Module
4. Configure Twitter API
5. Configure Statuses and Memes
6. Profit

1. Install Python
  1.1 - Go to https://www.python.org/, download and install VERSION 2.7 (NOT 3!)

2. Download Script
  2.1 - Go to https://pastebin.com/PWwErPpd
  2.2 - Copy script into text editor, save as "lomc.py"

3. Install Twitter API Module
  3.1 - Open command prompt or terminal, run following command to install required Python module:

	  Windows:
      C:\Python27\Scripts\pip.exe install TwitterAPI

	  MAC OSX:
		  sudo pip install TwitterAPI

	  Linux:
		  sudo pip install TwitterAPI

4. Configure Twitter API
  4.1 - Log into Twitter with desired account
  4.2 - Go to https://apps.twitter.com/
  4.4 - Click "Create New App"
  4.5 - Name = "<whatever you want>"
  4.6 - Description = "<whatever you want>"
  4.7 - Website = "<http://whateveryouwant.com>" (doesn't matter, as long as correctly formatted)
  4.8 - Callback URL = <leave blank> (doesn't matter)
  4.9 - Click Create Application
  4.10 - Go to "Keys and Access Tokens"
  4.11 - Double check that the "Access Level" is "Read and write"
  4.12 - Scroll down and click "Create my access token"
  4.13 - Open "lomc.py" script in text editor
  4.14 - Copy "Consumer Key (API Key)" into "consumer_key" variable (between the single quotes) at top of script (remove any space characters)
  4.15 - Copy "Consumer Secret (API Secret)" into "consumer_secret" variable (between the single quotes) at top of script (remove any space characters)
  4.16 - Copy both lines of "Access Token" into "access_token_key" variable (between the single quotes) at top of script (remove any space characters)
  4.17 - Copy "Access Token Secret" into "access_token_secret" variable (between the single quotes) at top of script (remove any space characters)
  4.18 - Save lomc.py script file

5. Configure Statuses and Memes
  5.1 - Put "lomc.py" script file into a desired directory (e.g C:\Temp\LOMC or /home/<user>/LOMC)
  5.2 - Create sub-directory called "statuses", fill it with tasty statuses, each one in a separate .txt file
  5.3 - Create sub-directory called "memes", fill it with spicy memes in .jpg, .jpeg, .png, .gif or .mp4 format

6. Profit
  6.1 - Open command prompt or terminal, run the script
    6.1.1 - Run command "cd <directory containing lomc.py>" e.g "cd C:\Temp\LOMC" or "cd /home/<user>/LOMC" to move into    the directory containing lomc.py
    6.1.2 - Run the lomc.py script using Python

	  Windows:
		  C:\Python27\python.exe lomc.py

	  MAC OSX:
		  python lomc.py

	  Linux:
		  python lomc.py

  6.2 - By default, LOMC will look for "statuses" and "memes" directories in its current directory.
        If you want to run multiple bots you can manually point each bot at your "statuses" and "memes" directories:

	  Windows:
		  C:\Python27\python.exe lomc.py <status_dir> <memes_dir>

	  MAC OSX:
		  python lomc.py <status_dir> <memes_dir>

	  Linux:
		  python lomc.py <status_dir> <memes_dir>


Please remember to meme responsibly.