Skip to content

A modern low-friction radio net logger purpose-built for emergency communications teams and SKYWARN spotter nets where multiple frequencis and modes may be in use.

License

Notifications You must be signed in to change notification settings

bradbrownjr/ectlogger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ECTLogger

A Modern Radio Net Logger

License: MIT

Whether you're running a casual weekly club net or coordinating a multi-agency emergency response, ECTLogger adapts to your needs. Start simple and grow into advanced features as your operations demand.

For community nets, keep things fun and engaging. Add a Topic of the Week to spark conversation, run polls to gather opinions, and let participants chat in real-time alongside the check-in log. The clean, modern interface makes logging effortlessβ€”no more wrestling with clunky desktop apps or decade-old web interfaces.

For SKYWARN and weather nets, capture what matters. Enable spotter number and weather observation fields to collect critical data from trained spotters. View check-in locations on an interactive map supporting entry of town and state, GPS coordinates, Maidenhead grid squares, UTM, and MGRS formats in the check-in's Location field β€” perfect for situational awareness during severe weather events.

For ARES and emergency communications, ECTLogger handles the complexity. Multiple NCS operators can work different frequencies simultaneously, with check-ins intelligently separated by band but logged together in one unified view. When the incident wraps up, generate ICS-309 Communications Logs with a single click for your after-action reports.

The responsive interface works beautifully on any device β€” from a phone in the field to a multi-monitor EOC workstation. Pop out the check-in list or chat into detachable windows within the browser to customize your workspace. Dark mode keeps things easy on the eyes during those long operational periods.

🌐 Try it now at app.ectlogger.us β€” No installation required!

Check-in Log

Multi-frequency/band check-ins, shown in dark and light mode! β€” πŸ“· More screenshots


✨ Features

Core Capabilities

  • πŸ” Secure Authentication β€” Frictionless sign-in with magic link email authentication + OAuth (Google, Microsoft, GitHub)
  • ⚑ Real-Time Updates β€” WebSocket-powered live check-ins, status updates, and chat messages
  • πŸ‘₯ Role-Based Access β€” Admin, NCS, Logger, User, and Guest roles
  • πŸ“§ Email Notifications β€” Automatic net reminders, start notifications, and invitations
  • πŸ“± Mobile Responsive β€” Works seamlessly on phones, tablets, and desktops
  • πŸ“» Multi-Frequency Support β€” Track stations across multiple frequencies and modes
  • πŸ‘₯ Multi-NCS Support - Multiple NCS operators can check in and track stations across multiple frequencies and modes simultaneously

Net Management

  • πŸ“… Scheduling β€” Schedule recurring nets with automatic NCS rotation
  • πŸ“œ Net Scripts β€” Create formatted scripts for NCS operators to follow during nets
  • ✏️ Inline Editing β€” NCS/Loggers can click any check-in row to edit fields directly
  • πŸ¦” Speed Entry - Hit the ⏩ button to enter a string of check-ins in fast-moving nets
  • πŸ”„ Recheck Tracking β€” Track stations as they check in and out, on different frequencies if needed
  • πŸ“Š Custom Fields β€” Admins can create custom fields for specific net requirements
  • πŸ“Š Poll Questions β€” Add poll questions to nets with real-time results chart
  • πŸ’¬ Topic of the Week β€” Prompt participants to share on a topic during check-in and track their answers
  • πŸ” Filter & Sort β€” Search and sort nets, schedules, frequencies, users, and fields
  • πŸ“‹ Card/List Views β€” Toggle between card and list views on Dashboard and Scheduler
  • πŸ“ Complete Net Logs β€” Automatic log generation and email delivery

Location & Mapping

  • πŸ—ΊοΈ Station Mapping β€” View check-in locations on OpenStreetMap
  • 🌐 Multiple Formats β€” Town & state, GPS, Maidenhead, UTM, MGRS coordinate support in Location check-in field
  • πŸ“ Location Awareness β€” Auto-fill Maidenhead grid square from browser location, if enabled by the end user

Multi-Frequency Net Support

ECT and SKYWARN nets often move between frequencies to meet participants where they are. ECTLogger tracks:

  • Multiple frequencies per net - Nets can support multiple active channels, frequencies, and modes
  • Active frequency indication - Users can see which frequency each NCS is active on so that they may follow
  • Per-station frequency tracking - Each station can check or re-check into more than one operating frequency
  • Real-time frequency change notifications - Freqency changes are updated to all users in real-time

Analytics & Reporting

  • πŸ“§ Emailed net closure reports - Net participants can receive chat logs, check-in logs, topic answers, and poll results
  • πŸ“ƒ ICS-309 Communications Log - For ARES and ECT nets, ICS-309 documents can be downloaded and emailed from closed nets
  • πŸ“ˆ Statistics & Analytics β€” Track participation trends, operator activity, and net performance with interactive charts
  • πŸ“„ Net Report (PDF) β€” Generate comprehensive multi-page PDF reports for closed nets including statistics, check-in logs, chat, and ICS-309 sections

πŸ‘₯ User Roles

ECTLogger has two types of roles: global roles (system-wide) and net roles (per-net assignments).

Global Roles

ECTLogger provides the following types of users:

Role Description
πŸ›‘οΈAdmin Full system access, user management, view all nets, configure custom fields
πŸ‘€User Create nets, check into nets, receive notifications
πŸ‘οΈGuest View-only access to public nets (no account required)

Net Roles

When a user creates a net, they automatically become its NCS (Net Control Station). The net creator can assign these roles to other users:

Role Description
πŸ‘‘NCS Full control: start/close net, manage check-ins, assign roles
πŸ“‹Logger Log check-ins and manage station status
πŸ“‘Relay Check in stations on behalf of others

Any registered user can run their own nets!

Station Status Tracking

Visual indicators for station status:

  • βœ… Checked In
  • πŸ‘‚ Just Listening
  • πŸ“» Available
  • ⏸️ Away
  • πŸ‘‹ Checked Out
  • πŸ”„ Recheck (returning stations)

A legend at the base of the check-in list identifies each status icon.


πŸ“‹ Net Workflow

1. Create Net

Define your net with name, description, frequencies, and required fields. Assign roles and save as draft.

2. Schedule (Optional)

Set date/time, configure recurring schedule, and set up NCS rotation with automatic reminders.

3. Start Net

NCS starts manually or net auto-starts if scheduled. Email notifications sent to subscribers.

4. Log Check-ins

NCS or logger enters check-ins with real-time updates to all connected clients.

5. Close Net

Complete log generated automatically and emailed to NCS. Net archived for reports.


πŸ“š Documentation

Getting Started

Document Description
User Guide How to use ECTLogger as a participant or NCS

Self-Hosting

ECTLogger can be self-hosted on your own server. See the self-hosting documentation:

Document Description
Self-Hosting Guide Overview of self-hosting options and requirements
Quick Start Get up and running in 5 minutes
Manual Installation Step-by-step installation for advanced users
Production Deployment Deploy with SSL/HTTPS and reverse proxy

Configuration

Document Description
Magic Link Configuration Configure magic link expiration
Email Deliverability Email setup and troubleshooting
Logging Configure log levels and debug output

Security

Document Description
Security Security features and best practices
Fail2Ban Automatic IP banning setup

Development

Document Description
Development Guide Architecture, API, and contributing

πŸ“„ License

This project is licensed under the MIT License β€” see the LICENSE file for details.

You can: βœ… Use commercially Β· βœ… Modify Β· βœ… Distribute Β· βœ… Use privately

With the requirement to include copyright notice and attribution.


πŸ™ Acknowledgments

Built for the amateur radio and emergency communications community.

Special thanks to all NCS operators, loggers, and participants who make emergency communication nets possible.


πŸ“ž Support

  • Issues: GitHub Issues
  • Documentation: See links above
  • Questions: Open a discussion on GitHub

73 and stay safe! πŸ“»

About

A modern low-friction radio net logger purpose-built for emergency communications teams and SKYWARN spotter nets where multiple frequencis and modes may be in use.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published