ajunlonglive / tinyconsole

📱💬🚦 TinyConsole is a micro-console that can help you log and display information inside an iOS application, where having a connection to a development computer is not possible.

TinyConsole

TinyConsole is a tiny log console to display information while using your iOS app and written in Swift.

Usage

Wrap your Main ViewController inside of a TinyConsoleController like so:

TinyConsole.createViewController(rootViewController: MyMainViewController())

Actions

Hide and Show

Shake your device to toggle the console. If you’re using the Simulator, press ⌃ ctrl-⌘ cmd-z.

Console output

// Print message
TinyConsole.print("hello")

// Print messages any color you want 
TinyConsole.print("green text", color: UIColor.green)

// Print a red error message 
TinyConsole.error("something went wrong")

// Print a marker for orientation
TinyConsole.addLine()

// Clear console
TinyConsole.clear()

Implementation Example

Instead of

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    window = UIWindow(frame: UIScreen.main.bounds)
    window?.rootViewController = MyMainViewController()
    window?.makeKeyAndVisible()
    return true
}

write

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    window = UIWindow(frame: UIScreen.main.bounds)
    window?.rootViewController = TinyConsole.createViewController(rootViewController: MyMainViewController())
    window?.makeKeyAndVisible()
    return true
}

alternatively, check out the example project included in this repository.

Demo

Requirements

• Xcode 11
• Swift 5
• iOS 11 or greater

Installation

Carthage

Add this to your Cartfile:

github "Cosmo/TinyConsole"

Manually

Just drag the source files into your project.

Hierarchy

Core Team

• @Cosmo, Devran "Cosmo" Uenal
• @mRs-, Marius Landwehr
• @ohitsdaniel, Daniel Peter

Thanks

Many thanks to the contributors of this project.

Contact

• Devran "Cosmo" Uenal
• Twitter: @maccosmo
• LinkedIn: devranuenal

Other Projects

• BinaryKit — BinaryKit helps you to break down binary data into bits and bytes and easily access specific parts.
• Clippy — Clippy from Microsoft Office is back and runs on macOS! Written in Swift.
• GrammaticalNumber — Turns singular words to the plural and vice-versa in Swift.
• HackMan — Stop writing boilerplate code yourself. Let hackman do it for you via the command line.
• ISO8859 — Convert ISO8859 1-16 Encoded Text to String in Swift. Supports iOS, tvOS, watchOS and macOS.
• SpriteMap — SpriteMap helps you to extract sprites out of a sprite map. Written in Swift.
• StringCase — Converts String to lowerCamelCase, UpperCamelCase and snake_case. Tested and written in Swift.

License

TinyConsole is released under the MIT License.