Merge bdf3a9a861a0a2351a5d7667ad325eafbafbc12b into a876fbd158e67d2dc87a0158d480ca71ebaeed9e

docs/media-players.md

@@ -0,0 +1,56 @@
+---
+title: "Media Players"
+icon: material/video
+description: Alternative Media Players for Videos, TV and Audio.
+cover: media-players.webp
+---
+<small>Protects against the following threat(s):</small>
+
+- [:material-account-cash: Surveillance Capitalism](basics/common-threats.md#surveillance-as-a-business-model){ .pg-brown }
+
+## Kodi
+
+<div class="admonition recommendation" markdown>
+
+![Kodi logo](assets/img/media-players/kodi.svg){ align=right }
+
+**Kodi** is a Free and Open Source (FOSS) client that can replace the interface of the likes of Smart TVs, it supports all variety of entertainment including TV (PVR), Music, Games, Videos (TV Shows, Movies) and Pictures. Kodi relies on content being stored locally or on the internet for things like Youtube or hardware to interface with things like TV (PVR) and you can use add-ons<sup>1.</sup> to extend the experience. Kodi is compatible with most operating systems and hardware, including Raspberry Pi, Linux, and Android, see the [requirements here](https://kodi.wiki/view/Supported_hardware) for running Kodi.
+
+[:octicons-home-16: Homepage](https://kodi.tv){ .md-button .md-button--primary }
+[:octicons-info-16:](https://kodi.wiki/){ .card-link title=Documentation}
+[:octicons-code-16:](https://github.com/xbmc/xbmc){ .card-link title="Source Code" }
+[:octicons-heart-16:](https://kodi.tv/contribute/){ .card-link title=Contribute }
+
+</details>
+
+</div>
+
+1. Kodi has an add-ons store to extend the out-of-the-box experience, but **keep in mind that add-ons are made by the community and the company itself, so be careful what you install,** luckily most software add-ons are also FOSS, meaning the code on them can be inspected, but in general be careful what you install, see the [addons site](https://kodi.tv/addons/) for more.
+
+Also, we advise against using it for Apple devices (outside of MacOS) as it requires jailbreaking them and jailbreaking reduces the security of the device, we recommend you have a Linux or an Android device for it instead if possible.
+
+## VLC Media Player
+<div class="admonition recommendation" markdown>
+
+![VLC logo](assets/img/media-players/vlc.png){ align=right }
+
+**VLC Media Player** is a Free and Open Source (FOSS) media player. It supports audio and video types of entertainment including TV (PVR), music and videos. VLC also relies on content being stored locally or can stream or play from the variety of hardware capture cards including tuner cards and online or on the local network too. Finally, VLC is also fully cross-platform and also has [add-ons](https://addons.videolan.org/) to extend the experience like Kodi, the same caution applies above.
+
+[:octicons-home-16: Homepage](https://www.videolan.org/vlc/){ .md-button .md-button--primary }
+[:octicons-info-16:](https://wiki.videolan.org/Main_Page/){ .card-link title=Documentation}
+[:octicons-code-16:](https://code.videolan.org/videolan/vlc){ .card-link title="Source Code" }
+[:octicons-heart-16:](https://www.videolan.org/contribute.html){ .card-link title=Contribute }
+
+</details>
+
+</div>
+Unlike Kodi, VLC is meant to be a software that runs on your device to open media locally or streams (like TV), so it doesn't cater to the big screen experience like Kodi does and doesn't have native remote control support or other inputs like it. Finally, while it does support opening images, it's not a good experience over using an image viewer and doesn't support games (where Kodi does well in that regard).
+
+## Criteria
+
+**Please note we are not affiliated with any of the projects we recommend.** In addition to [our standard criteria](about/criteria.md), we have developed a clear set of requirements to allow us to provide objective recommendations. We suggest you familiarize yourself with this list before choosing to use a project, and conduct your own research to ensure it's the right choice for you.
+
+- Must be open source.
+- Must support a wide variety of hardware.
+- Must have functionality that can replace the likes of Smart TVs. 
+<!--- Feel free to help with the criteria, I'm not sure PG's stance on those I'm going on my own --->

mkdocs.yml

@@ -421,6 +421,7 @@ nav:
           - "health-and-wellness.md"
           - "language-tools.md"
           - "maps.md"
+          - "media-players.md"
           - "multi-factor-authentication.md"
           - "news-aggregators.md"
           - "notebooks.md"