mirror of
https://gitlab.com/kelteseth/ScreenPlay.git
synced 2024-11-06 19:12:30 +01:00
101 lines
4.6 KiB
Markdown
101 lines
4.6 KiB
Markdown
<div>
|
|
<img width="100%" height="93" src="logo_gitlab_fullwidth.svg">
|
|
</div>
|
|
|
|
<div align="center">
|
|
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 <a href="https://store.steampowered.com/about/">Steam</a>.
|
|
Join our community: <a href="https://screen-play.app/">Homepage</a>, <a href="https://forum.screen-play.app/">Forum</a>
|
|
<br> Visit our <a href="https://kelteseth.gitlab.io/ScreenPlayDeveloperDocs/"> Developer C++ Classes Documentation</a> and our <a href="https://kelteseth.gitlab.io/ScreenPlayDocs/"> Getting Started Guide for creating Wallpaper and Widgets</a>!
|
|
<br>
|
|
<!--<h4><a href="https://steamcommunity.com/app/672870/">Download ScreenPlay!</a></h4>-->
|
|
<h4>Get a free Steam key for you and your friends here:</h4>
|
|
<h4> <a href="https://forum.screen-play.app/topic/2/we-are-open-for-alpha-testing-via-steam">Steam</a> or <a href="https://discordapp.com/invite/3RygPHZ">Discord</a></h4>
|
|
</div>
|
|
<br>
|
|
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
Everyone can contribute with code, design, documentation or translation. Visit our [contributing guide](https://gitlab.com/kelteseth/ScreenPlay/blob/dev/CONTRIBUTING.md) for more informations.
|
|
|
|
* If you want to help [translate](https://gitlab.com/kelteseth/ScreenPlay/blob/dev/CONTRIBUTING.md#translation)
|
|
* If you are a [programmer](https://gitlab.com/kelteseth/ScreenPlay/blob/dev/CONTRIBUTING.md#development)
|
|
* If you are a [designer](https://gitlab.com/kelteseth/ScreenPlay/blob/dev/CONTRIBUTING.md#design)
|
|
|
|
|
|
# Getting started
|
|
|
|
### Basic
|
|
1. Install latest [git + git-lfs](https://git-scm.com/)
|
|
2. Clone ScreenPlay
|
|
``` bash
|
|
git clone https://gitlab.com/kelteseth/ScreenPlay.git
|
|
```
|
|
3. Download the latest [__Qt 5.14__](https://www.qt.io/download-qt-installer). Earlier versions are not supported!
|
|
4. Start install-dependencies.bat to download dependencies into the Common/ folder
|
|
``` bash
|
|
.\install-dependencies.bat
|
|
```
|
|
* This will install these dependencies via __vcpkg__
|
|
* libzippp
|
|
* nlohmann-json
|
|
* Download these dependencies via __git submodules__
|
|
* stomt-qt-sdk
|
|
* qt-google-analytics
|
|
5. Follow the steps below for your OS. Then Open The ScreenPlay.pro via QtCreator.
|
|
6. Add install to the build steps. Projects -> Build -> Add Build Step -> Select Make -> Insert "install" into Make arguments.
|
|
7. Press build (the green play button). This will compile the project and copy all necessary files into your Qt installation.
|
|
|
|
### Windows
|
|
1. [Download and install MSVC 2019 Community](https://visualstudio.microsoft.com/vs/community/)
|
|
2. [Download and install Win 10 SDK (debugging support. Not included via the MSVC installer)](https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk)
|
|
- Select debugging support during the installation (CDB)
|
|
3. [Download and install Qt 5 binary installer from qt.io](https://www.qt.io/download-qt-installer)
|
|
- 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
|
|
|
|
### Linux
|
|
1. Install dependencies for your distro:
|
|
``` bash
|
|
# 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
|
|
```
|
|
2. [Download and install Qt 5 binary installer from qt.io](https://www.qt.io/download-qt-installer)
|
|
- 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
|
|
### OSX
|
|
1. Install XCode via the app store
|
|
2. Launch XCode and install the XCode command line tools. (This may take a few minutes)
|
|
- If in doubt or unsure, execute 'xcode-select --install'
|
|
3. [Download and install Qt 5 binary installer from qt.io](https://www.qt.io/download-qt-installer)
|
|
- 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
|
|
4. 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)
|