Created FAQ (markdown)

FAQ.md

@@ -0,0 +1,44 @@
+## General
+1. **What is this and why it was created?**
+
+This is an attempt of one guy sitting in his dark cave to build cross-platform video player that focuses on privacy-friendly front-ends and video services to give you simple and coherent experience between iOS, macOS and tvOS devices.
+I am building it as a hobby and to learn SwiftUI and Apple platforms development.
+This is my first big project like this. I am **not** a SwiftUI developer/mobile developer/user interface designer/technical documentation writer. I am doing it in my time off and sharing it for free with others. 
+
+2. **What should I expect with that app?**
+
+Nothing much really. Again, it's highly constrained by very limited time I can offer to develop this and the facts are that I am learning by building it and that it is my first SwiftUI project. There are plenty of known bugs, deficiencies and UI problems. It's also a perfect example of "YMMV" app (your mileage may vary). Performance is highly depending on what servers you are using it with. If you connect it to your local instance it will be nice and fast. If you use it with some public server that is overloaded and located far from you, you'll probably get frustrated how slow it can get.
+
+This is in-development and young project. I try to incorporate feedback of the users, so if you don't like some part of this app, instead of leaving salty comment on Discord or in the App Store, use your time to look for [issue](https://github.com/yattee/yattee/issues) and open new one if it does not exist.
+
+Remember, there is no support or further development guaranteed - as per [AGPL v3](https://www.gnu.org/licenses/agpl-3.0.en.html) license on which Yattee is shared.
+
+
+3. **How do I use Locations functionality?**
+
+Yattee can connect to the instances of the following apps:
+* [Invidious](https://github.com/iv-org/invidious)
+* [Piped](https://github.com/TeamPiped/Piped)
+
+You can simply add your custom location in Settings. It is important to use API URL (not front-end URL) of your instance.
+Use of this app with public instances is not endorsed.
+
+4. **What are the differences between using AVPlayer and MPV?**
+
+AVPlayer is a system player component delivered by Apple. It provides best efficiency, performance and system integrations, but number of playable videos formats is limited. This means for Invidious/Piped videos the maximum resolution you can play with it is 1080p. There's no way to play higher resolution files as they are not provided in the right formats. Obviously, modern Apple devices are more than capable to hardware decode and play these formats. And in fact, [Apple seems to be giving special entitlement to Google](https://forums.macrumors.com/threads/apple-m1-vp9-av1-decoding.2269938/page-2?post=29417159#post-29417159) that allows them to enable VP9/AV1 formats decoding. Just remember that next time you hear how Apple treats all developers equally.
+
+[mpv](https://mpv.io/) is an open source, free media player that offers much winder range of supported formats and is capable of playing 4K+ videos, using hardware decoding wherever possible. It uses custom playback controls. Due to implementation limitations it is not possible to start PiP or AirPlay from MPV directly, however app allows seamless switch to AVPlayer for opening PiP.
+
+## Platform specific
+### macOS
+1. **Is Yattee ever going to be available via the Mac App Store?**
+
+Not sure. Apple keeps rejecting macOS version of Yattee for several unrelated and random reasons. As I believe the App Store approval process is random and getting approval depends mostly on whether the reviewer has had a nice day, I keep resubmitting macOS versions with every update so maybe we will get lucky one day. For now I suggest you getting Yattee using [brew tap](https://github.com/yattee/yattee/wiki/Installation-Instructions#macos) or by downloading recent released version [directly from GitHub](https://github.com/yattee/yattee/releases).
+### tvOS
+1. **Why is the tvOS version is lacking scrubber in custom controls?**
+
+Apple did not care to create slider/scrubber component for tvOS (neither with [UIKit](https://developer.apple.com/documentation/uikit/uislider) nor [SwiftUI](https://developer.apple.com/documentation/swiftui/slider)). As I would very much like to implement it, this will require more time since it'll require to create custom UI component. I know it's frustrating not to have it. As a workaround, if you have an iOS device, you can scrub and control playback on Apple TV from Control Center in iOS.
+
+2. **Why some functionalities from iOS and macOS versions are missing in tvOS versions?**
+
+I always try to make new features available throughout all the platforms but sometimes because of framework/tools limitations (look question above) or need to spend more time to create UI that works fine for TV screen, I decide not to bring the functionality to tvOS. This version is also the least used between the 3 platforms (approximate platforms share is as follows: iOS - 85%, macOS - 10%, tvOS - 5%)