Skip to content

Commit

Permalink
Update Readme and add License
Browse files Browse the repository at this point in the history
  • Loading branch information
jonathanp0 committed Jan 23, 2022
1 parent d3e844e commit 0f927dc
Show file tree
Hide file tree
Showing 2 changed files with 43 additions and 32 deletions.
21 changes: 21 additions & 0 deletions cmd/departureboard/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2022 Jonathan

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.
54 changes: 22 additions & 32 deletions cmd/departureboard/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,20 @@ This is a Proof of Concept for a Station Arrivals/Departure Board generated from

## Changelog

### v0.2.0 23.01.22

- Command Line Interface replaced with Graphical Interface
- Convert TIPLOC Names on Location List and if necessary in Origin/Destination

#### Minor Changes
- Add Application Icon
- Replace "Unknown" with "On Time" and "Cancelled"
- Decrease refresh time from 60s to 15s
- Update Clock on Location List Screen
- Add Return Link to Board
- Improve Location List Styling
- Seperate Origin and Destination

### v0.0.1 14.01.22

Initial Release
Expand All @@ -12,40 +26,14 @@ Initial Release

1. Launch SimSig and start a Simulation, being sure to Enable the "Interface Gateway" on the "Primary" port.
2. Launch departureboard.exe
3. A file dialog will appear, use this to select the timetable that is running in SimSig.
4. A web browser will automatically be launched to access the web interface at http://localhost:8090/

If the software does not function as expected, please consult the error messages printed to the
console window. If the application exits immediately, it will be necessary to run the application from a "Command Prompt" in order to see these messages.

### Licensed Simulations

In case you are running a licensed simulation, your SimSig username and password must be supplied on the command line.
This can be done either from a "Command Prompt" or by creating a Windows Shortcut.

The command should have the following format: `depatureboard.exe -user <myusername> -pass <mypassword>`

## Command Line Reference
```
-all
Do not hide departed and terminated trains
-help
Print help text
-pass string
SimSig License Password(optional)
-server string
Simsig Interface Gateway Address (default "localhost:51515")
-user string
SimSig License Username(optional)
-verbose
Print received train movement messages
-wtt string
Path to Timetable file
```
3. Enter the Simsig Username and Password if running a licensed simulation
4. Click "Choose Timetable" and select the timetable that is in use in SimSig
5. Click "Connect" and wait whilst a connection is established to SimSig
4. Click the "Open Departure Board" link

### Customisation

The template files for the location list and depature board are loaded from tmpl\index.tmpl and board.tmpl respectively.
The template files for the location list and depature board are loaded from `tmpl\index.tmpl` and `tmpl\board.tmpl` respectively.
The visual appearance of the web interface can be customised by modifying these files.

## Author
Expand All @@ -69,4 +57,6 @@ FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TOR

## Attribution

Bulletin board icons created by Freepik - [Flaticon](https://www.flaticon.com/free-icons/flight-information)
Bulletin board icons created by Freepik - [Flaticon](https://www.flaticon.com/free-icons/flight-information)

Extracts from the [Network Rail Reference Data](https://www.networkrail.co.uk/who-we-are/transparency-and-ethics/transparency/open-data-feeds/) are included under the [Open Government License](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/)

0 comments on commit 0f927dc

Please sign in to comment.