https://github.com/theos/orion

Elegant tweak development in pure Swift
https://github.com/theos/orion

dsl ios jailbreak macos objective-c runtime swift swizzling theos

Last synced: 5 days ago
JSON representation

Elegant tweak development in pure Swift

• Host: GitHub
• URL: https://github.com/theos/orion
• Owner: theos
• License: mit
• Created: 2020-08-31T12:02:00.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2023-12-30T13:25:33.000Z (6 months ago)
• Last Synced: 2024-04-20T08:59:16.813Z (2 months ago)
• Topics: dsl, ios, jailbreak, macos, objective-c, runtime, swift, swizzling, theos
• Language: Swift
• Homepage: https://orion.theos.dev
• Size: 8.81 MB
• Stars: 189
• Watchers: 17
• Forks: 14
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Lists

• awesome-stars - orion
• awesome-swift-plugins - OrionPlugin - A plugin for running Orion Preprocessor. (Frameworks with plugins)

README

        
Orion

A DSL for elegant tweak development in Swift.



Theos –

Documentation –

Changelogs –

Get Help –

@theosdev –

IRC



## About

Orion is a [DSL](https://en.wikipedia.org/wiki/Domain-specific_language) designed to make it entirely effortless to interact with with Objective-C's dynamic aspects in Swift. The project's primary goal is to enable easy, fun, and versatile jailbreak tweak development in Swift. In some ways, it is to Swift what [Logos](https://github.com/theos/logos) is to Objective-C, but it's simultaneously a lot more than that.

It is possible to use Orion as a regular framework (invoking the preprocessor in a build script), or in a [Theos](https://github.com/theos/theos) tweak (recommended).

Orion _is not_ a framework for hooking Swift code. As of now, Orion only supports hooking Objective-C and C code, however this may change in the future.

For more information, refer to the [documentation](https://orion.theos.dev/getting-started.html).

## Example

The following is a simple tweak which changes the text of all labels to say "hello":

```swift

class MyHook: ClassHook {

    func setText(_ text: String) {

        orig.setText("hello")

    }

}

```

## License

See [LICENSE.md](https://github.com/theos/orion/blob/master/LICENSE.md) for licensing information.