← Back to Installation
Admin Guide
This guide covers administration features for race organisers, including event management, course setup, user management, and preparing for race day.
Two Types of Access:
- Manager password: Create and configure events at wstracker.org/manage.html
- Admin password: Per-event admin access for course setup, user editing, and track clearing
Quick Reference
Create Events
Set up new races/regattas
Set Course
Define start, marks, and finish
Edit Users
Change display names and roles
Clear Tracks
Reset before each race
Race Sub-logs
Mark races in track review
Export Tracks
GPX, CSV, GeoJSON, FIT
Creating and Managing Events
Each race or regatta is an "event" with its own tracking data, passwords, and course. Events are managed at the Event Management page.
2
Enter Manager Password
Enter the manager password to access event management. This password is provided by the server administrator.
3
Create a New Event
Click "Create Event" and fill in:
- Event Name: The name of your race or regatta (e.g., "NZ Interdominion 2026")
- Description: Optional details about the event
- Admin Password: Password for course setup, user editing, and track clearing
- Tracker Password: Password that participants enter in their tracking apps
Password Tips:
- The tracker password should be easy to share with participants
- The admin password should be kept private for race organisers only
- Each event has its own passwords - they don't affect other events
Managing Existing Events
From the Event Management page you can:
- Edit: Change event name, description, or passwords
- Archive: Hide completed events from the public list (data is preserved)
- View: Open the live tracking map for the event
Entering Admin Mode (Per-Event)
Each event has its own admin mode for course setup, user editing, and track management.
2
Click Admin Button
Click the Admin button in the top-right corner of the map.
3
Enter Event Admin Password
Enter the admin password for this event (set when the event was created). Once authenticated, you'll see additional admin controls appear.
Setting Up the Course
The course defines the start line, race marks, and finish line that are displayed on the map.
1
Enter Edit Course Mode
In admin mode, click the "Edit Course" button. The map will enter course editing mode.
2
Set the Start Position
Click on the map where the start line should be. A green marker will appear.
3
Add Course Marks
Click on the map to add each mark in order. Yellow markers will appear for each mark. Add as many marks as needed for your course.
4
Save the Course
When you've added all marks, long-press on the map to finish (or double-click on desktop). The last point becomes the finish with a checkered flag.
Tip: You can edit the course at any time. Changes take effect immediately for all viewers.
Editing User Names and Roles
You can change how participants appear on the map by editing their display name and role.
Why Edit Users?
- Display names: Change "S42" to "John Smith" for easier identification
- Sail Colours:Add the sail color for easy identification on the water
- Roles: Correct a user who registered with the wrong role (sailor, support, spectator)
- Auto-generated IDs: Users may appear with auto-generated IDs that you may want to rename
1
Find the User
Click on a user's marker on the map, or find them in the sailor list on the left side of the screen.
2
Click Edit
In admin mode, you'll see an "Edit" button in the user's popup or list entry. Click it.
3
Change Name or Role
In the edit dialog:
- Display Name: Enter a friendly name (e.g., "John Smith")
- Role: Select Sailor, Support, or Spectator
Leave the name blank to use the original ID.
4
Save Changes
Click "Save". The changes appear immediately on the map for all viewers.
| Role |
Icon |
Description |
| Sailor |
Windsurfer |
Race participants |
| Support |
Powerboat |
Safety boats, chase boats |
| Spectator |
Binoculars |
Observers, media |
Clearing Track Logs
Before each race, you should clear the track logs to start fresh. This removes the historical track lines from the live map and starts a new log file.
Data is preserved: Clearing tracks does not delete any data. It simply starts a new log file. All previous tracks remain available in the Track Review tool.
1
Enter Admin Mode
Click Admin and enter the password if not already in admin mode.
2
Click Clear Tracks
Click the "Clear Tracks" button in the admin panel.
3
Confirm
Confirm the action when prompted. Track history will be cleared from the live map and a new log started.
What Changes:
- Track lines (position history) cleared from live map
- A new log file is started on the server
What Remains:
- Current live positions
- User name/role overrides
- Course definition
- Previous log files (viewable in Track Review)
Race Day Checklist
Before the Race
- Verify the course is set correctly
- Clear track logs from any previous testing or races
- Check that all participants appear on the map
- Edit any user names that need clarification
- Confirm support boats are showing with correct role
During the Race
- Monitor the map for participant positions
- Watch for ASSIST alerts (flashing red markers)
- Check that all expected participants are transmitting
After the Race
- Track logs are automatically saved on the server
- Use Track Review to analyze the race
- Clear tracks before the next race if running multiple races
Track Review
After a race, use the Track Review page to analyze tracks in detail. Access it at https://wstracker.org/review.html and select your event.
Basic Features
- Date selection: Review tracks from any day
- Time range slider: Focus on specific portions of the race
- Speed coloring: Tracks colored from green (slow) to red (fast)
- Outlier filtering: Remove GPS glitches automatically
- Playback: Animate tracks with play/pause and draggable position indicator
- 30-second tail mode: Show only recent track history during playback
Race Sub-logs (Admin Feature)
Admins can create named race markers to quickly jump to specific races within a day's log.
1
Enable Admin Mode
In Track Review, open the Options menu and check "Admin Mode". Enter the event admin password when prompted.
2
Select Time Range
Use the time sliders to select the portion of the log that corresponds to a race.
3
Create Race Marker
Click the green "+" button next to the log name. Enter a name for the race (e.g., "Race 1", "Race 2").
Using Race Markers:
- Race markers appear indented below their parent log
- Click a race to jump to that time range with full slider resolution
- Double-click a graph or use Reset to return to full race range
- Share links that include the race selection
- Admins see a red "−" button to delete race markers
Available Graphs
Enable graphs from the "Graphs" dropdown to visualize:
- Speed: Speed over time in knots
- Distance: Cumulative distance traveled
- Battery: Battery level over time
- Signal: Mobile signal strength (0-4 bars)
- Latency: Network delay from phone to server
- Heart Rate: Heart rate from connected devices (Apple Watch)
- Accuracy: GPS accuracy in meters
Graph Interactions:
- Click on any graph to highlight the corresponding position on the map
- Drag to select a time range (rubber-band selection)
- Double-click to reset to full time range
- Drag the bottom edge of a graph to resize it
Export Tracks
Export track data for selected users using the Export button:
- GPX: Standard GPS format for most mapping apps
- CSV: Spreadsheet format with all data fields
- GeoJSON: Web mapping format
- FIT: Garmin format, compatible with Waterspeed app for GPS speed analysis
Sharing Links
Click the Copy Link button to share a URL that includes:
- Selected date and log
- Selected race (if any)
- Selected users
- Time range selection
- Map position and zoom
- Enabled graphs
Troubleshooting
User not appearing on map
- Check they have mobile signal/data connection
- Verify their app is configured with correct server and password
- Ask them to check their ACK rate (should be > 0%)
- For iPhone users, ensure the app has "Always" location permission
Track lines not showing
- Enable "Show Tracks" in the map controls
- Tracks only appear after multiple position updates
- Check if tracks were recently cleared
Course not visible
- Ensure you clicked "Save Course" after editing
- Refresh the browser page
- Check that course points are within the visible map area
← Back to Installation