mirror of
https://gitlab.com/kelteseth/ScreenPlay.git
synced 2024-09-02 16:49:47 +02:00
90 lines
6.2 KiB
Markdown
90 lines
6.2 KiB
Markdown
<div>
|
|
<img width="100%" height="93" src=".gitlab/media/logo_gitlab_fullwidth.svg">
|
|
</div>
|
|
<div align="center">
|
|
<br>
|
|
|
|
ScreenPlay: [![pipeline status](https://gitlab.com/kelteseth/ScreenPlay/badges/master/pipeline.svg)](https://gitlab.com/kelteseth/ScreenPlay/-/commits/master) Docs: [![pipeline status](https://gitlab.com/kelteseth/ScreenPlayDeveloperDocs/badges/master/pipeline.svg)](https://gitlab.com/kelteseth/ScreenPlayDeveloperDocs/-/commits/master) [![Crowdin](https://badges.crowdin.net/screenplay/localized.svg)](https://crowdin.com/project/screenplay) <a href="https://twitter.com/kelteseth">![Twitter Follow](https://img.shields.io/twitter/follow/kelteseth?style=for-the-badge)</a> <a href="https://www.reddit.com/r/ScreenPlayApp/">![Subreddit subscribers](https://img.shields.io/reddit/subreddit-subscribers/screenplayapp?style=for-the-badge)</a> <a href="https://discord.com/invite/4sY9d4f2DM">![Discord](https://img.shields.io/discord/516635043435773970?style=for-the-badge)</a>
|
|
<h3><a href="https://store.steampowered.com/app/672870/ScreenPlay/">✨Download ScreenPlay with via Steam™ with Workshop support✨</a> </h3>
|
|
<h3><a href="http://gitlab.com/kelteseth/ScreenPlay/-/jobs/artifacts/master/download?job=build:windows_release">✨💻 Download ScreenPlay Windows directly✨</a> </h3>
|
|
<h3><a href="http://gitlab.com/kelteseth/ScreenPlay/-/jobs/artifacts/master/download?job=build:osx_release">✨🍏 Download ScreenPlay macOS (unsigned) directly✨</a> </h3>
|
|
|
|
![](/.gitlab/media/preview.webp)
|
|
|
|
<a href="https://www.youtube.com/watch?v=q-J2fTWDxw8"><p>Watch the Steam Early Access Trailer (YouTube)</p></a>
|
|
|
|
[中文总览](README_zh_CN.md)
|
|
|
|
ScreenPlay is an Open Source cross-platform app for displaying Video Wallpaper & Widgets. It is written in modern C++20/Qt6/QML. <br> <a href="https://screen-play.app/">Homepage</a> - <a href="https://forum.screen-play.app/">Forums</a>- <a href="https://discord.com/invite/4sY9d4f2DM">Discord</a>
|
|
|
|
<h3><a href="https://kelteseth.gitlab.io/ScreenPlayDocs/Building%20ScreenPlay/">Developer setup guide on how to download and compile ScreenPlay yourself.</a> </h3>
|
|
|
|
</div>
|
|
|
|
# Content Creation
|
|
[Learn the basics of QML for Wallpapers and Widgets in 5 minutes](https://screen-play.app/blog/guide_learn_the_basics_of_qml/)
|
|
<div>
|
|
<a href="https://kelteseth.gitlab.io/ScreenPlayDocs/wallpaper/wallpaper/"><img src=".gitlab/media/wallpaper_guide.png"></a>
|
|
</div>
|
|
|
|
* [Video Wallpaper](https://kelteseth.gitlab.io/ScreenPlayDocs/wallpaper/video_wallpaper/). You can import any WebM file directly or use the importer for any other video type.
|
|
* [Performance Guidelines](https://kelteseth.gitlab.io/ScreenPlayDocs/wallpaper/wallpaper/). You need a modern GPU for smooth playback. You can always use QML/HTML/GIF wallpaper if you encounter performance issues!
|
|
* [Video import via Handbrake](https://forum.screen-play.app/topic/43/fast-bulk-video-conversion-with-handbrake). Handbrake offers easy bulk import of videos.
|
|
|
|
<div>
|
|
<a href="https://kelteseth.gitlab.io/ScreenPlayDocs/widgets/widgets/"><img src=".gitlab/media/widgets_guide.png"></a>
|
|
</div>
|
|
|
|
|
|
* [Widgets Guide](https://kelteseth.gitlab.io/ScreenPlayDocs/widgets/widgets/). General guidelines how to create widgets. ScreenPlay uses the easy to learn QML language. No coding knowledge required!
|
|
* [Storage Widget](https://kelteseth.gitlab.io/ScreenPlayDocs/widgets/example_Storage/). Display your drives and usage.
|
|
* [CPU Usage Widget](https://kelteseth.gitlab.io/ScreenPlayDocs/widgets/example_CPU/). Displays your current CPU usage.
|
|
* [RSS Feed Widget](https://kelteseth.gitlab.io/ScreenPlayDocs/widgets/example_RSS/). Display news as a rss widget.
|
|
|
|
|
|
# General Contributing
|
|
|
|
Everyone can contribute with code, design, documentation or translation. Visit our [contributing guide](https://kelteseth.gitlab.io/ScreenPlayDocs/contribute/contribute) for more information. Also checkout our [Collaboration Guidelines](Docs/CodeOfConduct.md).
|
|
|
|
Here are some ways you can contribute:
|
|
* by using prerelease versions / master branch or the Steam nightly builds
|
|
* by [adding/fixing translation](https://crowdin.com/project/screenplay)
|
|
* by [designing UI/UX](https://kelteseth.gitlab.io/ScreenPlayDocs/contribute/contribute/#design)
|
|
* by [creating example HTML/QML/Javascript content](https://kelteseth.gitlab.io/ScreenPlayDocs/)
|
|
* by [reporting bugs](https://gitlab.com/kelteseth/ScreenPlay/-/issues)
|
|
* by [writing user documentation](https://gitlab.com/kelteseth/ScreenPlayDocs)
|
|
* by [coding needed features](https://gitlab.com/kelteseth/ScreenPlay/-/issues?label_name%5B%5D=Feature)
|
|
* by [refactoring code](https://gitlab.com/kelteseth/ScreenPlay/-/issues?label_name%5B%5D=Code+Quality)
|
|
* by [reviewing merge requests](https://gitlab.com/kelteseth/ScreenPlay/-/merge_requests)
|
|
* by [verifying issues](https://gitlab.com/kelteseth/ScreenPlay/-/issues?label_name%5B%5D=Unverified)
|
|
|
|
# Development
|
|
* [**Developer setup guide on how to download and compile ScreenPlay yourself.**](https://kelteseth.gitlab.io/ScreenPlayDocs/Building%20ScreenPlay/)
|
|
* If you want to contribute but don't know how to start, take a look at our open issues and WIP merge request.
|
|
* If you need help don't hesitate to ask me (Kelteseth) via:
|
|
* [Create a forum topic with a detailed description](https://forum.screen-play.app/category/2/general-discussion)
|
|
* [discord channel general](https://discord.gg/3RygPHZ)
|
|
* [ScreenPlay project overview](Docs/ProjectOverview.md)
|
|
* [Developer C++ Classes Documentation](https://kelteseth.gitlab.io/ScreenPlayDeveloperDocs/)
|
|
|
|
# Platform support
|
|
|
|
* ❌ Not working/Not implemented
|
|
* ❓ Only partially implemented/Not tested, help needed
|
|
|
|
<div align="center">
|
|
|
|
| Feature | Windows | Linux X11 and Wayland (layer shell) | MacOS |
|
|
|------------------------ |--------- |------- |------- |
|
|
| __ScreenPlay Main App__ | ✔ | ✔ | ✔ |
|
|
| __Steam Binaries__ | ✔ | ❌ | ✔ |
|
|
| __Wallpaper__ | ✔ | ✔ | ✔ |
|
|
| __Widgets__ | ✔ | ✔ | ✔ |
|
|
| __Multilanguage (EN,DE,RU,FR,ES,KO,VI,CH_ZN,PT_BR🆕)__ | ✔ | ✔ | ✔ |
|
|
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|