• Stars
    star
    251
  • Rank 156,626 (Top 4 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created about 9 years ago
  • Updated over 5 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A free and open source xkcd comic reader for iOS.

Banner

Build Status GitHub license Coverage Status

A free, ad-free, open-source, native, and universal xkcd.com reader for iOS. Download it from the app store now!

portrait

Architecture

Version History

  • v2.5 (Submitted to the App Store)

    • iPhone X support
    • Added support for the four most common languages used by users other than English. German, Simplified Chinese, Spanish, and Russian.
    • Conducted full accessibility audit and implemented improvements.
    • Added 3d-touch previewing of comics from list.
    • New light-weight iOS app rating prompt replaced old alert-view style implementation.
    • Minor bug fixes and improvements
  • v2.4

    • Bookmarking comics - If you enjoy reading all the comics in order, you can bookmark a comic from the comic screen and we've provided an option from the main comic list to be taken back to where you left off at any time.
    • The "alt" view now includes the comic number as well as a "Explain" button that will take you to the explainXKCD site for that comic, in case you'd like a little more context.
    • View All Unread - quickly filter out all viewed comics, seeing only unread comics in the list.
    • Clear Cache - deletes all comics, resets all saved information including
    • View Bookmarked Comic - As previously mentioned, when you select this menu option you will be taken back to the comic you bookmarked and can continue browsing in-order.
    • View All Comics - this option will return to the unfiltered list if any of the above filters were applied.
  • v2.3

    • Fixes a comic view controller zooming issue caused by zooming in on a comic, viewing the alt text, then moving to the next/prev comic, resulting in the comic being zoomed out too far.
    • Added a Today Widget showing the most recent comic.
    • Removed GTrack and Google Analytics libraries.
  • v2.2

    • Fixes an issue with some of the known interactive comics, using a web view controller instead of the native comic view controller as a stop-gap until we work out some other solution.
    • Ask users to leave a review, only once ever, to get some more feedback.
    • Swipe navigation between comics.
    • Share sheet.
    • Moved alt button to bottom for easier use on larger devices.
    • Random comics can be viewed from the comic list, making it easier to randomly browse.
  • v2.1.1

    • iOS 9 networking bug fix (#29)
  • v2.1

    • Share comics to Facebook and Twitter
  • v2.0

    • Added the ability to favorite a comic, which is indicated on the comic list with a pretty red heart. Along with this, you're able to toggle a filter on the comic list to see only favorites
    • Roll-the-dice to view a random comic
    • Navigate forward and backward through comics directly from the comic view controller
    • Fixed a potential issue with comics not loading on the first launch
  • v1.2

    • Visual indication that comics are read vs. unread
    • Improved comic view layout so some comics won't be cut off by the alt button
    • Hopefully corrected issue related to disappearing push notifications
  • v1.1

    • Improved scrolling performance
    • Search beta
    • Silent push notifications w/ vibration & app badge
    • Bug fixes
  • v1.0

    • Initial Release - you can read comics and stuff...

Contributors

Want to help?

Download the app and use it - give us feedback! Leave a star on the repo, and a review on the app. If you find any bugs, have any feature requests, or want to say mean and nasty things to me, open an issue, and if you can patch the bug or add a feature and submit a pull request, even better - just make sure to follow the same code formatting/style and BE SURE TO ADD TESTS if applicable.

License / Attribution

The source is made available under the MIT license. See LICENSE.txt for details. For information regarding xkcd licensing, click here.

Social sharing icons from Zlatko Najdenovski via a Creative Commons Attribution 3.0 Unported License.

More Repositories

1

Onboard

An iOS framework to easily create a beautiful and engaging onboarding experience with only a few lines of code.
Objective-C
6,469
star
2

Neon

A powerful Swift programmatic UI layout framework.
Swift
4,566
star
3

Facade

Programmatic view layout for the rest of us.
Objective-C
689
star
4

Organic

The intuitive UITableViewController.
Objective-C
644
star
5

MAThemeKit

Create an iOS app color theme using a single line of code.
Objective-C
552
star
6

MAFormViewController

Quick and easy iOS forms.
Objective-C
289
star
7

Follower

Track trip distance, speed, altitude, and duration like a boss.
Objective-C
194
star
8

Wethr

Wethr provides developers the ability to add location-based current weather conditions to their views as simply as adding any UIView.
Objective-C
170
star
9

Evolve

An Evolution Simulation Engine written in Objective-C.
Objective-C
73
star
10

MALoggingViewController

MALoggingViewController is a real-time pseudo-console you can embed in your application, perfect for testing and debugging in the real world. Whether you are determining the reliability of network traffic while driving through areas with poor service, testing push notifications on ad-hoc builds while not connected to Xcode, or working out those pesky Core Location bugs, there's no need to carry around half of your development environment with you. No more driving around town with the Xcode console open, or having to handle logging to files and emailing them later to figure out what the heck happened - you can see all the data on your device, anywhere, in real time.
Objective-C
53
star
11

MAPageViewController

MAPageViewController is a simple wrapper around the most common boiler-plate UIPageViewController setup.
Swift
51
star
12

MAActionCell

Objective-C
34
star
13

MATextFieldCell

MATextFieldCell is a drop-in subclass of UITableViewCell, written in Swift, used for drastically streamlining UITableView-based form creation.
Swift
22
star
14

Essentials

A curated list of things I wish I knew about Objective-C, Xcode, and Cocoa Touch when I started programming iOS apps.
Objective-C
14
star
15

MADial

MADial and MATimerDial are UIViews that can quickly and easily be created to add slick circular sliders or minute/second timers to your views.
Objective-C
9
star
16

MontyHall

A swift implementation of the famous Monty Hall problem, attempting to explain the counter-intuitive nature of the puzzle.
Swift
4
star
17

Swift-State-Machine

A swift implementation of the state machine design pattern - with a demo implementation.
Swift
1
star