Rewrote README, added build instruction, remove info that is on website
Dieser Commit ist enthalten in:
Ursprung
f7b087a562
Commit
4663b4cf1c
84
README.md
84
README.md
@ -1,34 +1,66 @@
|
||||
# Traintastic
|
||||
# Traintastic - Model railway control software
|
||||
|
||||
[](https://github.com/traintastic/traintastic/actions/workflows/build.yml) 
|
||||
|
||||
*Free and open source model railway control software*
|
||||
|
||||
## What is Traintastic?
|
||||
## About The Project
|
||||
Traintastic is a client/server software application to control a model railway. It is in an early stage of development, it contains very limited functionality.
|
||||
|
||||
## Goal?
|
||||
Develop free and open source software which can control all aspects of a model railway.
|
||||
- Cross platorm: Windows, Linux and macOS
|
||||
- Multilingual software and user manual
|
||||
- Easy to learn for new users
|
||||
- Manual and automatic train operation
|
||||
- Extensable by experienced users using scripting
|
||||
The project goal is to develop open source software that can control everything in your model railway layout. More information can be found using the links below:
|
||||
|
||||
## What can it currently do?
|
||||
- Control locomotive decoders, via LocoNet, XpressNet or Z21.
|
||||
- Act as WLANmaus controller, so the WLANmaus/Z21 app can be used with any command station.
|
||||
- [Download Traintastic](https://traintastic.org/download)
|
||||
- [Traintastic Manual](https://traintastic.org/manual)
|
||||
- [Traintastic hardware support](https://traintastic.org/supported-hardware)
|
||||
- [Traintastic development roadmap](https://traintastic.org/roadmap)
|
||||
|
||||
### Supported command stations
|
||||
- LocoNet:
|
||||
- Digikeijs DR5000
|
||||
- Uhlenbrock Intellibox
|
||||
- other LocoNet compatible command stations should work
|
||||
- XpressNet:
|
||||
- Digikeijs DR5000 (untested)
|
||||
- Roco 10764
|
||||
- other XpressNet compatible command stations should work
|
||||
- Z21:
|
||||
- Digikeijs DR5000
|
||||
- Roco/Fleischmann Z21 (untested)
|
||||
- other Z21 compatible command stations should work
|
||||
|
||||
## Build Traintastic from source
|
||||
|
||||
*This section is only for developers, if your just want to use it [download Traintastic](https://traintastic.org/download).*
|
||||
|
||||
|
||||
### Requirements:
|
||||
|
||||
- Client:
|
||||
- C++ compiler: MSVC, GCC or Clang
|
||||
- Visual Studio 16 2019 (Windows only)
|
||||
- CMake 3.9+
|
||||
- Qt 5.15+
|
||||
- Server:
|
||||
- C++ compiler: GCC or Clang (MSVC doesn't work yet)
|
||||
- Visual Studio 16 2019 (Windows only)
|
||||
- CMake
|
||||
- liblua5.3 (Linux only)
|
||||
- Manual:
|
||||
- Python 3.6+ (older versions untested)
|
||||
- pycmarkgfm (`pip3 install pycmarkgfm`)
|
||||
|
||||
Note: When cloning the source from git, git-lfs is required.
|
||||
|
||||
|
||||
### Build Traintastic client
|
||||
|
||||
- From the project root go into the client directory: `cd client`
|
||||
- Create a build directory: `cmake -E make_directory build`
|
||||
- Go into the created build directory: `cd build`
|
||||
- Run CMake:
|
||||
- Windows: `cmake ../ -G "Visual Studio 16 2019" -A x64 -DCMAKE_BUILD_TYPE=Release`
|
||||
- Linux: `cmake ../ -DCMAKE_BUILD_TYPE=Release`
|
||||
- Build traintastic-client: `cmake --build . --config Release`
|
||||
|
||||
|
||||
### Build Traintastic server
|
||||
|
||||
- From the project root go into the server directory: `cd server`
|
||||
- Create a build directory: `cmake -E make_directory build`
|
||||
- Go into the created build directory: `cd build`
|
||||
- Configure CMake:
|
||||
- Windows: `cmake ../ -G "Visual Studio 16 2019" -A x64 -T ClangCL -DCMAKE_BUILD_TYPE=Release -DUSB_XPRESSNET=OFF`
|
||||
- Linux: `cmake ../ -DCMAKE_BUILD_TYPE=Release -DUSB_XPRESSNET=OFF`
|
||||
- Build traintastic-server: `cmake --build . --config Release --target traintastic-server`
|
||||
|
||||
|
||||
### Build Traintastic manual
|
||||
|
||||
1. From the project root go into the manual directory: `cd manual`
|
||||
2. Run the build script: `python3 builddoc.py html-single-page --output-dir build`
|
||||
|
||||
Laden…
x
In neuem Issue referenzieren
Einen Benutzer sperren