mirror of
https://gitlab.com/kelteseth/ScreenPlay.git
synced 2024-11-23 19:22:35 +01:00
.gitlab/issue_templates | ||
Common | ||
Docs | ||
Legal | ||
ScreenPlay | ||
ScreenPlaySDK | ||
ScreenPlaySysInfo | ||
ScreenPlayWallpaper | ||
ScreenPlayWidget | ||
.clang-format | ||
.gitattributes | ||
.gitignore | ||
.gitlab-ci.yml | ||
.gitmodules | ||
CHANGELOG.md | ||
CONTRIBUTING.md | ||
install-dependencies.bat | ||
LICENSE | ||
logo_gitlab_fullwidth.svg | ||
preview.mp4 | ||
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 PMThe 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
.\install-dependencies.bat
- 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 Win 10 SDK (debugging support. Not included via the MSVC installer)
- Select debugging support during the installation (CDB)
- 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
- Developer and Designer Tools
- Qt Creator 4.x CDB Debugger Support
- OpenSSL 1.1.1.c Toolkit
- OpenSSL 64-bit binaries
- 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
- Developer and Designer Tools
- OpenSSL 1.1.1.c Toolkit
- OpenSSL 64-bit binaries
- OpenSSL 1.1.1.c Toolkit
- 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)