Warning, /network/kdeconnect-ios/README.md is written in an unsupported language. File is not indexed.

0001 # The Official Repository of KDE Connect iOS
0002 
0003 **TL;DR: [Download from the App Store](https://apps.apple.com/app/kde-connect/id1580245991) on an iOS >= 14 device!**
0004 
0005 ---
0006 
0007 This project is the iOS version of the group of applications called KDE Connect, which uses the LAN network to integrate devices together. For information on KDE Connect, check out:
0008 
0009 - [The KDE Community Wiki](https://community.kde.org/KDEConnect)
0010 - [The KDE UserBase Wiki](https://userbase.kde.org/KDEConnect)
0011 
0012 If you would like to talk to the KDE Connect developers & contributors (for questions or if you would like to contribute!), please join the [KDE Connect development Telegram channel](https://t.me/joinchat/AOS6gA37orb2dZCLhqbZjg).
0013 
0014 ## Beta Testing
0015 
0016 In addition to the App Store, you can also get the public testing version of KDE Connect iOS
0017 by opening [this TestFlight link](https://testflight.apple.com/join/vxCluwBF).
0018 This version also supports running on Macs with Apple silicon.
0019 
0020 ## Known Behavior and Problems
0021 
0022 - iOS is very much designed around foreground interactions. Therefore, background “daemon-style” applications don’t really exist under conventional means, so the behavior where **KDE Connect iOS is unresponsive in the background is more or less intended**. There are technically some special categories and "hacky" methods to try to get it to run in the background, but in general, there is no intended/by-design method of keeping a "daemon-style" app running forever in the background. For more information, see [this post on the Apple Dev Forums](https://developers.apple.com/forums/thread/685525)
0023 - Notification syncing doesn't work because iOS applications can't access notifications of other apps
0024 
0025 ## Bug Reporting
0026 
0027 Please feel free to give feedback about/report bugs in the TestFlight version through:
0028 
0029 - System Settings app: you can report general information such as the number of app launches and crashes by enabling Settings > Privacy > Analytics & Improvements > Share iPhone Analytics > Share with App Developers
0030 - TestFlight's integrated screenshot feedback system: upon taking a screenshot of the app, tap "export" to see an option to send it as feedback to the developer (us)
0031 - TestFlight's integrated crash feedback system: upon app crashing, an alert will appear asking you if you would like to send the crash data along as feedback
0032 - [KDE Bugzilla](https://bugs.kde.org/enter_bug.cgi?product=kdeconnect&component=ios-application)
0033 
0034 ### Data Disclosure Notice
0035 
0036 - If you don't send ANY feedback AND have "Share with App Developers" disabled, the ONLY information that the KDE developers can access about you is the date that you've installed the TestFlight app.
0037 - Enabling "Share with App Developers" discloses general information such as the number of app launches and crashes with the KDE Connect developers.
0038 - Sending feedback through TestFlight's integrated screenshot feedback system OR TestFlight's integrated crash feedback system will disclose:
0039   - User email (if chosen to disclose)
0040   - Device model
0041   - iOS version
0042   - Battery level
0043   - Cellular carrier (if applicable)
0044   - Time zone
0045   - Architecture
0046   - Connection type (Wifi, etc.)
0047   - Free space on disk and total disk space available
0048   - Screen resolution
0049   - (For Crash feedback) stack trace leading to crash
0050 - Sending feedback through [KDE Bugzilla](https://bugs.kde.org/enter_bug.cgi?product=kdeconnect&component=ios-application) lets you manually disclose as much or as little information as you would like, but all information will have to be investigated manually.
0051 
0052 ## Contributing
0053 
0054 We keep track of tasks for KDE Connect iOS using [Phabricator](https://phabricator.kde.org/project/board/159/) and accept changes through KDE Invent GitLab [merge requests](https://invent.kde.org/network/kdeconnect-ios/-/merge_requests).
0055 
0056 Many tasks only include a high level description and could be easily misinterpreted, so we'd recommend first starting a conversation in the task you are interested in implementing with your high level plan before diving into coding. Especially since KDE Connect iOS 2021 makes heavy use of both Swift and Objective-C and needs to support multiple iOS versions, it can be a bit confusing at first, so feel free to ask the developers some questions!
0057 
0058 ### Extending to Additional Platforms
0059 
0060 - [ ] [Expand to a watchOS](https://community.kde.org/SoK/Ideas/2022#Investigate_Feasibility_of_KDE_Connect_for_watchOS) companion/standalone app?
0061 - [ ] [Expand to macOS](https://community.kde.org/GSoC/2022/Ideas#Project:_Porting_the_KDE_Connect_iOS_app_to_macOS) with catalyst/native SwiftUI?
0062 
0063 ## History of KDE Connect iOS
0064 
0065 This project is a continuation of [KDE Connect 2014](https://invent.kde.org/wxiao/kdeconnect-ios), a codebase that stemmed from the Google Summer of Code 2014 program that remained largely untouched since 2014 until getting picked up again by [Inoki](https://invent.kde.org/wxiao) in 2019, where some tweaks were added to it to support TLS.
0066 
0067 KDE Connect 2021 was started as a project for Google Summer of Code 2021 by student Lucas Wang. As of mid-August 2021, the app compiles and is able to perform all of the functionalities currently implemented (though there are likely some bugs to be found). Currently, the app is not yet ready for Release distribution as it lacks certain functionalities compared to the other KDE Connect versions that either need to be implemented or are likely unviable to implement due to iOS restrictions.
0068 
0069 If you would like to check out some other posts about KDE Connect iOS, please see:
0070 
0071 - [Lucas's blog](https://students.washington.edu/zxlwang/kde_list) contains many articles covering technical overviews of this project as well as its origin and plans for the future
0072 - [Lucas's Google Summer of Code Status Report](https://community.kde.org/GSoC/2021/StatusReports/LucasWang) is another place to view a report of this project
0073 
0074 ### Troubleshooting build
0075 
0076 If you get the error `Plug-in ended with uncaught signal: 4` whent trying to run SwiftLint as part of the build, run the following command:
0077 
0078 ```
0079 sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
0080 ```