Awful / Awful.apk

Native Android client for the Something Awful forums
110 stars 66 forks source link

Awful

Awful is an unofficial viewer for the SomethingAwful forums on Android platforms. Come check out the Awful forum thread!

Get it on Google Play

Terms and Conditions for usage of this app

If you are a Google Play review-bot (or actual flesh automaton), you can find the forum rules (or "terms of user/user policy") at this address on the interwebs. I'm not sure why you would look for them here, but you do you.

Contributing

Want to help? Come join us in the development and beta testing thread, and join the beta testing program.

Or take a look at our issues and set up your own fork to quash some bugs!

Build using Android Studio (recommended)

  1. Download and install Android Studio.
  2. Fork Awful.apk on Github.
  3. Download your fork's Git repository and open the project in Android Studio.
    • Quick way: from the welcome screen, choose Get from VCS and enter the Github URL for your new fork.
  4. (Optional) If you'd like to be able to upload images to Imgur:
    1. Register a new application for the Imgur API.
    2. Create the file secrets.xml in /Awful.apk/src/main/res/values/.
    3. Place the client ID in secrets.xml, like so:
      <?xml version=1.0 encoding="utf-8"?>
      <resources>
      <string name="imgur_api_client_id">YOUR_CLIENT_ID</string>
      </resources>
  5. Build > Make Project should run without any issues!

Further questions or problems? Please let us know in the dev thread.