https://github.com/twidereproject/twiderex-ios
Next generation of Twidere for iOS.
https://github.com/twidereproject/twiderex-ios
Last synced: 12 months ago
JSON representation
Next generation of Twidere for iOS.
- Host: GitHub
- URL: https://github.com/twidereproject/twiderex-ios
- Owner: TwidereProject
- License: gpl-3.0
- Created: 2020-08-31T08:41:10.000Z (almost 6 years ago)
- Default Branch: develop
- Last Pushed: 2023-11-30T09:47:52.000Z (over 2 years ago)
- Last Synced: 2024-12-05T20:35:12.510Z (over 1 year ago)
- Language: Swift
- Homepage:
- Size: 13.7 MB
- Stars: 154
- Watchers: 11
- Forks: 10
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Support: Support/ExportOptions.plist
Awesome Lists containing this project
README
# Twidere X
[](https://crowdin.com/project/twidere-x)
Next generation of Twidere for iOS.
[](https://apps.apple.com/app/twidere-x/id1530314034)
## Requirements
- Xcode 13.0+
- Swift 5.5+
- iOS 15+
## Quick Start
Before clone and install the dependency. You need [apply](https://developer.twitter.com/en/apply-for-access) for the Twitter developer and setup Twitter [APIv2](https://blog.twitter.com/developer/en_us/topics/tools/2020/introducing_new_twitter_api.html) App to use the OAuth API key. Make the app permissions to "Read, Write, and Direct Messages" and enable "3-legged OAuth". Copy and save your API key and API key secret.
All you need
- Twitter app `API key` and `API key secret`
- The latest Xcode from the App Store
- A `.env` file contains the keys. Check the [.env](./env/.env) template and create yours
```zsh
git clone https://github.com/TwidereProject/TwidereX-iOS
cd TwidereX-iOS
gem install bundle
bundle install
# For contributor
bundle exec arkana -e ./env/.env.Homebrew -f Homebrew
# For App Store release
# bundle exec arkana -e -f AppStore
bundle exec pod install
open TwidereX.xcworkspace
```
After open the project in the Xcode. Choose TwidereX scheme and build and run the app by ⌘R.
Note:
The `host_key_public` is preserved by App Store release and not needs for the open-source build. And you may needs to change bundle identifier in the Xcode to avoid conflict.
## Translation
The localization resource files locate in [TwidereX-Localization](https://github.com/TwidereProject/TwidereX-Localization) repo. We are welcome translator use our [Crowdin](https://crowdin.com/project/twidere-x) project contribute.
## Acknowledgements
- [Alamofire](https://github.com/Alamofire/Alamofire)
- [AlamofireImage](https://github.com/Alamofire/AlamofireImage)
- [AlamofireNetworkActivityIndicator](https://github.com/Alamofire/AlamofireNetworkActivityIndicator)
- [Arkana](https://github.com/rogerluan/arkana)
- [cocoapods-keys](https://github.com/orta/cocoapods-keys)
- [CommonOSLog](https://github.com/mainasuk/CommonOSLog)
- [CryptoSwift](https://github.com/krzyzanowskim/CryptoSwift)
- [DateToolSwift](https://github.com/MatthewYork/DateTools)
- [Floaty](https://github.com/kciter/Floaty)
- [Kanna](https://github.com/tid-kijyun/Kanna)
- [KeychainAccess](https://github.com/kishikawakatsumi/KeychainAccess)
- [Kingfisher](https://github.com/onevcat/Kingfisher)
- [LineChart](https://github.com/nhatminh12369/LineChart)
- [PageBoy](https://github.com/uias/Pageboy)
- [Popovers](https://github.com/aheze/Popovers)
- [swift-nio](https://github.com/apple/swift-nio)
- [SwiftGen](https://github.com/SwiftGen/SwiftGen)
- [SwiftMessages](https://github.com/SwiftKickMobile/SwiftMessages)
- [SwiftyJSON](https://github.com/SwiftyJSON/SwiftyJSON)
- [Tabman](https://github.com/uias/Tabman)
- [TOCropViewController](https://github.com/TimOliver/TOCropViewController)
- [twitter-text](https://github.com/twitter/twitter-text)
- [TwitterProfile](https://github.com/OfTheWolf/TwitterProfile)
- [webpush-fcm-relay](https://github.com/mastodon/webpush-fcm-relay)
- [ZIPFoundation](https://github.com/weichsel/ZIPFoundation)
## License
TwidereX-iOS is released under the GPLv3 license. See [LICENSE](./LICENSE) for details.