mirror of
https://gitlab.com/kelteseth/ScreenPlay.git
synced 2024-09-18 08:22:33 +02:00
.gitlab | ||
Common | ||
Docs | ||
Legal | ||
ScreenPlay | ||
ScreenPlaySDK | ||
ScreenPlaySysInfo | ||
ScreenPlayWallpaper | ||
ScreenPlayWidget | ||
.clang-format | ||
.gitattributes | ||
.gitignore | ||
.gitlab-ci.yml | ||
.gitmodules | ||
CONTRIBUTING.md | ||
install-dependencies.bat | ||
install-dependencies.sh | ||
LICENSE | ||
README.md | ||
ScreenPlay.pro |
ScreenPlay is an open source cross plattform app for displaying Wallpaper, Widgets and AppDrawer. It is written in modern C++17/Qt5/QML. Binaries with workshop support are available for Windows/Linux/MacOSX via Steam.
Join our community: Homepage, Forum
Visit our Developer C++ Classes Documentation and our Getting Started Guide for creating Wallpaper and Widgets!
Visit our Developer C++ Classes Documentation and our Getting Started Guide for creating Wallpaper and Widgets!
Get a free Steam key for you and your friends here:
Forums or Discord
or Reddit PMPlatform support
- ❌ Not working/Not implemented
- ❓ Only partical implemented/Not tested
Feature | Windows | Linux | MacOS |
---|---|---|---|
ScreenPlay Main App | ✔ | ✔ | ✔ |
Steam Binaries | ✔ | ❌ | ❌ |
Wallpaper | ✔ | ❌ Help Needed for Gnome/KDE/etc! | ❓ (Basic implementation) Help Needed! |
Widgets | ✔ | ❓ | ❓ Help Needed! |
Multilanguage (EN,DE,RU,FR,ES) | ✔ | ✔ | ✔ |
Plattform | Windows 7 | Windows 8/8.1 | Windows 10 | Gnome | KDE | XFCE |
---|---|---|---|---|---|---|
Wallpaper | ❓ Help Needed! | ❓ Help Needed! | ✔ | ❌ Help Needed! | ❌ Help Needed! | ❌ Help Needed! |
The ScreenPlay Project
- General user docs. Contains infromations about content creation for ScreenPlay. Hosted on gitlab, made with mkdocs:
- Contribute at: https://gitlab.com/kelteseth/ScreenPlayDocs
- View at : https://kelteseth.gitlab.io/ScreenPlayDocs/
- Developer docs generated from the ScreenPlay source code of this repo. Hosted on gitlab, made with qDoc:
- Contribute at: https://gitlab.com/kelteseth/ScreenPlayDeveloperDocs
- View at : https://kelteseth.gitlab.io/ScreenPlayDeveloperDocs/
- Discussons and content can be found via:
- Discord: https://discord.gg/3RygPHZ
- Forum: https://forum.screen-play.app/
- Reddit: https://www.reddit.com/r/ScreenPlayApp/
Contributing
Everyone can contribute with code, design, documentation or translation. Visit our contributing guide for more informations.
- If you want to help translate
- If you are a programmer
- If you are a designer
Getting started
Basic
- Install latest git + git-lfs
- Clone ScreenPlay
git clone https://gitlab.com/kelteseth/ScreenPlay.git
- Download the latest Qt 5.14. Earlier versions are not supported!
- Start install-dependencies.bat to download dependencies into the Common/ folder
//Windows
.\install-dependencies.bat
//Linux
chmod +x install-dependencies.sh
.\install-dependencies.sh
- This will install these dependencies via vcpkg
- libzippp
- nlohmann-json
- openSSL 1.1.1d
- Download these dependencies via git submodules
- stomt-qt-sdk
- qt-google-analytics
- Follow the steps below for your OS. Then Open The ScreenPlay.pro via QtCreator.
- Add install to the build steps. Projects -> Build -> Add Build Step -> Select Make -> Insert "install" into Make arguments.
- Press build (the green play button). This will compile the project and copy all necessary files into your Qt installation.
Windows
- Download and install MSVC 2019 Community
- Download and install Qt 5 binary installer from qt.io
- Install the Maintaince tool
- Select the following features to install:
- Qt 5.14.0
- MSVC 2017 64-bit
- Qt WebEngine
- Qt 5.14.0
Linux
- Install dependencies for your distro:
# Debian/Ubuntu
sudo apt install build-essential libgl1-mesa-dev
# Fedora/RHEL/CentOS (yum)
sudo yum groupinstall "C Development Tools and Libraries"
sudo yum install mesa-libGL-devel
# openSUSE (zypper)
sudo zypper install -t pattern devel_basis
- Download and install Qt 5 binary installer from qt.io
- Install the Maintaince tool
- Select the following features to install:
- Qt 5.14.0
- GCC
- Qt WebEngine
- Qt 5.14.0
OSX
- Install XCode via the app store
- Launch XCode and install the XCode command line tools. (This may take a few minutes)
- If in doubt or unsure, execute 'xcode-select --install'
- Download and install Qt 5 binary installer from qt.io
- Install the Maintaince tool
- Select the following features to install:
- Qt 5.14.0
- Qt WebEngine
- Developer and Designer Tools
- OpenSSL 1.1.1.c Toolkit
- OpenSSL 64-bit binaries
- OpenSSL 1.1.1.c Toolkit
- Qt 5.14.0
- Change your default kit: QtCreator -> Options -> Kits -> Select your default kit (Desktop Qt 5.13.0) -> Change c and c++ Compiler to Apple Clang (x86_64)