multimedia/plasmatube/README.md

0001 <!--
0002 SPDX-FileCopyrightText: 2019 Linus Jahn <lnj@kaidan.im>
0003 SPDX-FileCopyrightText: 2021 Carl Schwan <carl@carlschwan.eu>
0004
0005 SPDX-License-Identifier: CC0-1.0
0006 -->
0007
0008 # <img src="org.kde.plasmatube.svg" width="40"/> PlasmaTube
0009
0010 YouTube video player based on [mpv](https://mpv.io/), [yt-dlp](https://github.com/yt-dlp/yt-dlp), and [Invidious](https://github.com/iv-org/invidious).
0011
0012 <a href='https://flathub.org/apps/details/org.kde.plasmatube'><img width='190px' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-i-en.png'/></a>
0013
0014 ![Screenshot](https://cdn.kde.org/screenshots/plasmatube/plasmatube.png)
0015
0016 ## Features
0017
0018 * Invidious account support, and watching subscriptions.
0019 * Related videos.
0020 * Search and trending support.
0021
0022 ## Supported Sources
0023
0024 PlasmaTube currently supports the following video sources:
0025
0026 * [PeerTube](https://joinpeertube.org/)
0027 * [Invidious](https://invidious.io/)
0028 * [Piped](https://github.com/TeamPiped/Piped)
0029
0030 (Currently Invidious is the most mature source.)
0031
0032 ## Get It
0033
0034 Details on where to find stable releases of PlasmaTube can be found on it's
0035 [homepage](https://apps.kde.org/plasmatube).
0036
0037 ## Support
0038
0039 If you have an issue with PlasmaTube, please [open a support thread on KDE Discuss](https://discuss.kde.org/c/help/6).
0040
0041 ## Building
0042
0043 The easiest way to make changes and test PlasmaTube during development is to [build it with kdesrc-build](https://community.kde.org/Get_Involved/development/Build_software_with_kdesrc-build).
0044
0045 ## Contributing
0046
0047 Like other projects in the KDE ecosystem, contributions are welcome from all. This repository is managed in [KDE Invent](https://invent.kde.org/multimedia/plasmatube), our GitLab instance.
0048
0049 * Want to contribute code? See the [GitLab wiki page](https://community.kde.org/Infrastructure/GitLab) for a tutorial on how to send a merge request.
0050 * Reporting a bug? Please submit it on the [KDE Bugtracking System](https://bugs.kde.org/enter_bug.cgi?format=guided&product=plasmatube). Please do not use the Issues
0051   tab to report bugs.
0052 * Is there a part of PlasmaTube that's not translated? See the [Getting Involved in Translation wiki page](https://community.kde.org/Get_Involved/translation) to see how
0053   you can help translate!
0054
0055 If you get stuck or need help with anything at all, head over to the [KDE New Contributors room](https://go.kde.org/matrix/#/#kde-welcome:kde.org) on Matrix. For questions about PlasmaTube, please ask in the [Plasma Mobile room](https://go.kde.org/matrix/#/#plasmamobile:kde.org). See [Matrix](https://community.kde.org/Matrix) for more details.