reddit is fun · themes

Getting started

For designers & developers


You'll need the following to make themes.


The following are optional, and recommended.

  • Koneki LDT (Lua IDE. Available standalone or as Eclipse plugin)

  1. git clone the sample theme's git repo.
  2. Rename the directory to your theme's unique id:

    mv redditisfun.3.light com.example.cooltheme

  3. Change the theme settings in settings.json.
  4. Make your changes locally. Remember to git commit often!

    See the API docs for in-depth theme creation topics.

  1. git clone the xml2lua git repo.
  2. Load the project in Eclipse. TODO Ant script
  3. Run Layout2Lua or Drawable2Lua with a single argument: path to the XML file.
  4. It will output a .lua file in the project's working directory. Move that to your theme directory and modify it as needed.

  1. Push your theme to the device:

    adb push /desktop/com.example.cooltheme /sdcard/mycoolthemes/com.example.cooltheme

  2. Launch reddit is fun
  3. Menu -> Theme
  4. Enable Developer mode checkbox
  5. Select your theme directory, e.g., /sdcard/mycoolthemes/com.example.cooltheme
  6. Restart the app (press Back)
  7. If the theme file has errors, the theme will not show up. Instead, the error and stack trace will appear in a dialog.

These are instructions for getting your theme into the theme shop.

I recognize it's a very manual process right now. If anyone has a better way to handle this, I'm all ears.

  1. Update the manifest.json file to show correct version. For a new theme, will be version 1.
  2. Zip the theme directory. You will have, e.g., containing a single top-level directory named com.example.cooltheme. As usual substituting com.example.cooltheme with your theme's unique id.
  3. Optionally password protect the zip using your zip program.
  4. Upload the zip to a location I can download from.
  5. Take screenshots and post on imgur.
  6. PM zip URL (with zip password) and screenshots URL to /u/talklittle on reddit.
  7. I will respond to you when I have downloaded the zip, so you can delete the file from the server if you want.
  8. Once I have tested it, I'll let you know if accepted or rejected from the theme shop.

    Themes served from the theme shop will be compiled, and the Lua scripts therein will not be human-readable.