From e3a1e0e28408dfb5de71aed8bcaa45e8f0c154f5 Mon Sep 17 00:00:00 2001 From: Tarasa24 Date: Sun, 24 Nov 2019 16:39:09 +0100 Subject: [PATCH] README and LICENSE --- LICENSE.md | 21 +++++++++++++ README.md | 89 ++++++++++++++++++++++++++++++------------------------ 2 files changed, 71 insertions(+), 39 deletions(-) create mode 100644 LICENSE.md diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..1c771f8 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2019 Tarasa24 + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md index b80168d..d6e1afc 100644 --- a/README.md +++ b/README.md @@ -1,65 +1,76 @@

SCS Discord Rich Presence

-Euro Truck Simulator 2 & American Truck Simulator +Unofficial Open-source Discord Rich Presence for ETS2 and ATS

+--- -___ ## Table of contents + - [General info](#general-info) - [Technologies](#technologies) -- [Requirements and Setup](#requirements-and-setup) +- [Setup](#setup) - [Execution](#execution) -- [Contributing](#contributing) +- [Contact](#contact) +- [Build from source](#Build-from-source) - [Acknowledgement](#acknowledgement) ## General info -This project is simple discord rich presence for SCS software games ETS2 and ATS (possibly more in the future 🤞). -Project is bound on json files in folder *cities*. Don't move individual executables / python scripts from respective folders. +As the name suggests, this project provides Rich presence for Discord, displaying information like: -Here is quick preview: +- Transported cargo +- It's respective tonnage +- Distance to the destination +- Manufacturer and model of your truck +- Speed +- And approximate position in the world -![cmd_view](https://i.imgur.com/bgJTTS2.png) ![Discord Rich Presence](https://i.imgur.com/nyazDBN.png) -![cmd_view ATS](https://i.imgur.com/hpABirQ.png) ![Discord Rich Presence ATS](https://i.imgur.com/em4T5Th.png) +![cmd_view](https://i.imgur.com/cgIU28C.png) +![Discord Rich Presence](https://i.imgur.com/RyL4qdj.png) +![cmd_view ATS](https://i.imgur.com/tVpYvPE.png) +![Discord Rich Presence ATS](https://i.imgur.com/5cIMkJb.png) ## Technologies -Project is created with: -* pypresence -* ETS2 Log to Coordinates -* SDK plugin -* SDK python client -* PyInstaller - -## Requirements and Setup -You need to download latest release of SDK plugin and put .dll to the folder as described below. - -``` -..\steamapps\common\\bin\win_x64\plugins -or -..\steamapps\common\\bin\win_x86\plugins -``` -___ -**Only if you are planning to run python scrip**, you will need: Python itself and dependencies. - -[Python](https://www.python.org/) 🐍 -``` -$ cd .\SCS_RPC\python -$ pip install -r requirements.txt -``` + +Created using: + +- pypresence +- ETS2 Log to Coordinates +- SDK plugin +- cx_Freeze +- Inno Setup + +## Setup + +Download [latest release](https://github.com/Tarasa24/SCS_RPC/releases) and run the installer. Any further setup isn't necessary. ## Execution -Simply run **SCS_RPC.exe** -Alternatively execute **app.py** when using Python from inside python folder. +Simply run **SCS_RPC.exe** located in the root installation directory. + +Alternatively run any of batch files, likewise included in the root installation directory. These are used for automatically starting the rich presence along side of your game. These files are generated in the installer using provided paths to ets2 and or ats root directory. -## Contributing -Take a look at example json. If you have any idea how to nicely utilize this data even more, hit me up on discord: **Tarasa24**#1761 +| Batch files | +| ------------------------ | +| ats_x64 and SCS_RPC.bat | +| ats_x86 and SCS_RPC.bat | +| ets2_x64 and SCS_RPC.bat | +| ets2_x86 and SCS_RPC.bat | -. +## Contact + +In case of any question hit me up on Discord **Tarasa24**#1761 as this is my obviously preferable mean of communication. + +## Build from source + +Navigate yourself to the [Wiki](https://github.com/Tarasa24/SCS_RPC/wiki) section (which is in time of writing work in progress). + +--- ###### Acknowledgement -I am not related to the company **SCS software s.r.o.** in any sense. This project is non-profit and open source. This project represents funbase both of SCS software and Discord. -Any problems relating use of company name and/or their logo, will be resolved asap. I don't really want deal with **any** legal disputes regarding this project. Thank you for understanding. + +I am not related to the company **SCS software s.r.o.** in any sense. This project is non-profit and open source. This project represents fanbase both of SCS software and Discord. +Any problems relating the use of company name and/or their logo, will be resolved asap. I don't want deal with **any** legal disputes regarding this project. Thank you for understanding.