sgoudelis/ground-station v0.1.83 on GitHub

Docker Image

Version: 0.1.83
Environment: production
Git Commit: 5baca02
Build Date: 20260209

Commits in this release:

5baca02 Bump version to 0.1.83 in version.json.
6805bcf "Enhance session snapshot display to support sub-session filtering and improve chip labeling for consumer entries."
5994d31 "Add session_id_hint support to IQ broadcaster for improved session ID resolution and metadata enrichment; update related subscriptions for enhanced flexibility."
6c5efbf Update SDR waterfall view description and image in README.md to highlight live transcription overlay
f8ce9b9 Add GMSK decoding feature highlight and image to README.md; remove outdated logo section.
263795a Remove detailed scheduler documentation from README.md; add DSP topology image and description to enhance feature highlights.
3662e06 "Add decoder support flags and tooltips for unsupported decoders in VFO mode selectors; update UI to disable and inform users of limitations."
d8519ab Remove references to Morse/CW decoder from AboutPage, README.md, and diagrams; update planned and implemented features accordingly.
6a4316e Add Hamlib rig control feature to README.md feature list
c9e9fff "Revamp AboutPage with new features, updated descriptions, and improved user interface; update library references and add GitHub link in README.md."
990832e Remove outdated overview page section and image from README.md to streamline document content.
348485f Add DEVELOPMENT.md to document development setup, build steps, workflows, and decoder support; update README.md with new feature descriptions, images, and usage enhancements.
0d466df "Add session_id to task handlers and VFO state configuration for improved session tracking and management."
b14d36f "Fix debug logging in TLE deduplication: add callable check for logger.debug to prevent potential errors."
57d37af "Update Gemini transcription worker: switch to audio modality, upgrade Live API model, and refine audio streaming configuration."
c815e9b "Add timezone and locale props to VFOSubtitle component; propagate settings to improve localization support."
26df111 "Update rig control: add validation to disable connect button when selectedRadioRig is invalid."
523a53f "Remove unused rig columns (pttstatus, lodown, loup) from backend and frontend; update database schema, validation logic, and UI components accordingly."
967fb28 "Update PreferencesForm: simplify transcription service naming by removing 'DeBabel' prefix and adjust related UI text."
95a0866 "Refactor date and time handling: centralize formatting logic in utility functions and hooks; update components to use user-defined timezone and locale settings."
f3e432a "Refactor observation events import in scheduler: replace direct imports with namespace imports for improved clarity and maintainability; adjust log level in TLE sync utils."
83922dc "Fix debounced VFO state updates: ensure fresh state is read at update time to prevent stale active/selected values from being sent to the backend."
47ebdf8 "Refactor SDR configuration handling: centralize logic into SDRConfig dataclass and replace inline dictionaries across handlers for improved maintainability and readability."
6fc4789 "Add transmitter import support for SatDump and gr-satellites sources; integrate backend handlers and new frontend components."
c07398b "Enable geostationary satellites display by default in timeline and overview components."
bd5c5e1 "Add robust type coercion for SDR parameters; ensure fallback defaults and improved logging for invalid or unsupported inputs."
a416bd7 "Add validation fallback for SDR frequency limits and improve DC spike offset handling in Waterfall settings."
506f288 "Add gr-satellites bookmark source support across waterfall features: extend filtering, UI components, and translations in all supported languages."
82e49df "Improve details dialog in file browser: set custom width, enhance styling with PaperProps, and replace static image with ZoomableImage for better functionality and responsiveness."
8f0981c "Enhance observation timeline details: add task and pass duration formatting, improve status and scheduling information display, and handle fallback values more gracefully."
5ca3aa3 "Add support for PPM error correction in SDR workers and lifecycle: enable frequency adjustments based on PPM configuration and log updates."
bc4bcd4 "Expand SDR configuration support: add handling for antenna, offset_freq, recording_path, and loop_playback parameters."
66f7254 "Streamline waterfall status bar display logic: simplify handling of non-streaming states by introducing '-' as default placeholders for metrics and properties."
6bf38be "Add bookmark source filtering support to waterfall features: enable source-specific filtering in bookmarks overlay, toolbar, and slice state management; normalize transmitter sources throughout the application."
1f3c60a "Adjust label positioning logic in bookmarks overlay for improved spacing and alignment; add ELEKTRO-L support to pipelines and observation executor."
8727843 "Add safeguards for SatDump output directory handling: check for decoded images, clean up empty directories, and raise errors for missing outputs."
d955100 "Refine toast container styles: adjust width constraints, improve text behavior, and enhance responsiveness for better display across viewports."
070d3a9 "Add NORAD ID validation to active pass determination logic in target popover to ensure correct satellite pass matching."
e0c7047 "Refactor regeneration logic: introduce separate handlers for selected satellites and all enabled satellites, add validation for no enabled monitors, and improve UI tooltips and layout styling."
f5ad434 "Add tracker notification support for task completion: ensure consistent updates for satellites and transmitters via notify_tracking_inputs_from_db and improve TLE sync error handling."
e037de6 "Improve tasks popover styling: enhance responsiveness with breakpoint-based adjustments, ensure better width handling for smaller screens, and apply dynamic theming support."
31a9583 "Remove unnecessary imageSx styling from file browser dialog components to simplify code."
3b9c8a9 "Replace custom zoom/pan implementation in file browser dialogs with reusable ZoomableImage component for streamlined functionality."
6fbf92c "Improve metadata handling in file browser: add validation for metadata object types and use safe defaults for missing keys."
d4333dd "Refactor tracker inputs and hardware management: replace database dependency with IPC-driven state updates, integrate hardware change notifications, and enhance transmitter and ephemeris handling."
22a1b57 "Refine toast container styling: improve responsiveness, adjust width constraints, and add mobile-specific padding adjustments."
6cf7732 "Introduce reusable ZoomableImage component and integrate it into file browser dialogs for enhanced zoom/pan functionality."
12531f7 "Add guard pixel handling for Robot SSTV modes and improve chroma value assignment logic in YUV decoding."
7d767ba "Remove SSTV Decoder v2 implementation from the backend as it is no longer required."
04f1197 "Add option to delete IQ recordings after SatDump processing and implement corresponding UI and backend changes."
d4f55c7 "Add support for disabling timestamps in toasts and refine SatDump processor arguments with new options"
770827d "Add zoom and pan functionality to recording snapshots in the file browser, including scroll-to-zoom, cursor tracking, and frequency/time overlays."
10b237a "Add transmitter source display to frontend components and default to 'manual' in backend for missing sources."
43ec1ab "Reduce default auto-generation interval from 12 to 6 hours in observation constants to improve scheduling frequency."
b7cd0bd "Add initial data loading state management: implement progress tracking, improve connection overlay, and refactor app data initialization for better user feedback during synchronization."
27aeb6d "Integrate tlesync state management: add sync state updates and error logging to ensure compatibility with frontend expectations."
9b11737 "Enhance transmitter import tool: add support for SatYAML module, refactor YAML file collection logic, and improve fallback handling for YAML directory resolution."
657e994 "Enhance transmitter import tool: add support for SatYAML module, refactor YAML file collection logic, and improve fallback handling for YAML directory resolution."
0a622a3 "Add resolve_yaml_dir function to handle YAML directory resolution and improve error handling for missing or invalid directories in transmitter import tool."
ca0d405 Remove deprecated LoRa TX tools and add new transmitter import tools for gr-satellites and SatDump sources with database support.
49bc3ab "Switch to preciseHumanizeFrequency for improved frequency display accuracy in Waterfall settings"
dd345fc "Refactor SatDumpProcessor and UHDWorker: simplify buffer handling, remove sample accumulation logic, and streamline sample processing for improved efficiency and clarity."
e2a68a6 "Refactor observation timing notifications: add start notification scheduling logic, improve cleanup on component unmount, and enhance toast display handling for better user experience."
8d10c66 "Change log level from warning to debug for satellite tracking state group ID check in tracker logic."
e902770 "Refactor file browser and synchronization logic: update visited tracking, simplify file syncing notifications, and improve file timestamp validation."
66a05dd "Add delay between session startups to prevent overlap during execution"
db3b827 "Refactor file browser and observation countdown toast: improve decoded folder chip logic, streamline toast component, and enhance styling for consistency and usability."
6456ae5 "Add MeteorHrptFolderDialog: implement new dialog component for browsing and interacting with Meteor HRPT decoded folders in the file browser."
8ff7ddb "Add custom styling for countdown text in observation countdown toast to improve readability and alignment."
9b39847 "Add countdown toast for upcoming observations: introduce live countdown and auto-progress updates to enhance user awareness and event tracking."
4cfe4fc "Update Satellite Table and Group Dropdown: switch to labeled OutlinedInput for Select components to enhance accessibility and UI consistency."
dd95c2c "Refactor Transmitters Dialog: introduce reusable TransmittersDialog component and update references for improved consistency and maintainability."
754bcba "Replace MeteorFolderDialog with MeteorM2xLrptFolderDialog: refactor file browser component for improved structure and naming consistency."
a589717 "Fix decimation UI placement: move decimation-related components for IQ recording tasks to the correct location in dialogs for consistency and proper functionality."
afa45d7 "Replace tasks with sessions: refactor validations, database schema, and frontend components to enable multi-SDR session support."
95011cb "Add 'showNeighboringTransmitters' support: enable persistence in store and set default to true for improved functionality."
4f9c1e2 "Refactor Tasks Popover: add compact output mode, task expansion handling, and improve overall UI/UX consistency for better task overview and interaction."
37e4cae Remove SatDump parsers: delete satdumpparser.py and satdumpweatherdecoder.py to streamline the codebase.
4e7ac9c "Refactor Satellite Table: simplify CSS for enhanced virtual scroller styling and maintain horizontal scrolling support."
eb91ea8 "Update Satellite Table: switch from 'filled' to 'outlined' variants for FormControl, Select, and TextField to align with modern UI design."
8ca6f89 "Add SDR count tracking: enhance backend task updates and frontend notifications with active SDR count support."
1ae747f "Add SDR count tracking: enhance backend task updates and frontend notifications with active SDR count support."
b5554cf "Adjust file browser page size dynamically based on screen size and view mode for improved responsiveness."
bb91a42 "Refactor file details dialog: enhance styling with consistent spacing, improved typography, and better metadata organization for creation/modification details."
345d02a "Add input validation and error handling for hardware tables with dynamic error messaging and helper text support."
b47f11f "Standardize input field sizes: add consistent 'small' size for TextField, FormControl, and Select components across hardware tables to improve UI uniformity."
701a631 "Refactor file browser and dialogs: enhance metadata display styling, improve UI consistency, and add better handling of long text and command previews."
56ac9d2 Update Greek locale: capitalize action buttons for satellite database management
af21b03 "Add satellite add/edit/delete functionality: implement dialogs, Redux state management, and backend integration for satellite database operations."
e635de9 "Add pinch-to-zoom support for image preview in MeteorFolderDialog: implement multi-touch gesture handling for zooming and panning."
19baae1 "Add SatDump post-processing support: integrate pipeline selection in UI, update recording tasks, and enable configurable post-processing options."
5882775 "Enhance time difference formatting: add hours and minutes display for large differences, improve readability for countdowns."
0086e3c "Refactor background task handling: unify task management with Redux thunks, add SoapySDR discovery support, and streamline file browser task initiation."
0f5da53 "Remove redundant navigation tests across e2e specs for improved maintainability."
3c5be67 "Enable display of geostationary satellites in Timeline component."
86496cc "Fix loading overlay placement in TimelineCanvas to ensure proper alignment and visual consistency."
771d127 "Increase internal VFO capacity to 10: update VFOManager, recorder handlers, and decoder tasks for expanded VFO support."
b941951 "Add decimation support for IQ recording: implement backend processing, sample rate adjustment, and UI configuration options."
abc1a1e "Update folder download button text in MeteorFolderDialog to 'DOWNLOAD ZIP' for improved clarity."
afbd712 "Add folder download functionality: implement zipped folder download endpoint in backend and update MeteorFolderDialog to use it."
c2fd9f7 "Add waterfall generation: implement menu options in file browser and backend support for various SigMF datatypes."
ea98a42 "Extend ANSI color parsing in tasks popover: add support for multiple codes and additional color codes for improved output formatting."
77900dd "Improve zoom and pan behavior in MeteorFolderDialog: add cursor-centered zooming and refined pan calculation for smoother interactions."
2957235 "Add zoom and pan functionality to MeteorFolderDialog: enable image zoom, pan, and double-click reset for an improved viewing experience."
5598ff8 "Add task tracking and status updates to ProcessingDialog: improve UX with progress indicators and task duration display."
30b1271 "Enhance image card display in MeteorFolderDialog: add dynamic title parsing with getImageTitle for improved labeling."
f74ee03 "Refactor tasks popover output display: extract reusable TaskOutputTerminal component with auto-scroll support."
e613108 "Filter out 'Loading pipelines from file' messages in SatDumpProcessor for cleaner progress parsing."
8803030 "Filter out trace (T) messages in SatDumpProcessor for cleaner progress parsing; fix file table to prioritize modified timestamps over created ones."
b80a685 "Filter out debug messages from SatDump output in SatDumpProcessor task to ensure cleaner progress parsing."
a0cf3c7 "Handle SatDump exit code 1 as a valid successful state if decoded products are generated."
674efd5 Update Dockerfile: add libhdf5-dev to support HDF5 library integration in GNU Radio.
9062d68 "Update Dockerfile: enable official products plugin in SatDump build configuration."
a9af8fc "Update Dockerfile: disable Aaronia SDR plugin in SatDump build configuration."
034f7e4 "Strip invalid UTF-8 replacement characters from tasks popover output to ensure clean text processing."
ba2d81f "Increase task output log limit in tasks popover from 40 to 1000 lines for improved visibility."
a57e632 "Add empty directory cleanup logic to SatDump task; ensure cleanup after process failures or exceptions."
9ac5d06 "Add ANSI color parsing to tasks popover output and enhance output styling with color and bold support."
581c4c2 "Update Dockerfile: add libvolk-dev and libnng-dev; use isolated VOLK 3.2 build for GNU Radio; streamline SatDump dependencies and build process."
50e3c84 "Add SatDump dependencies and build steps to Dockerfile; include nng library compilation and SatDump installation without GUI."
9a93b88 "Introduce SatDump IQ recording processing: backend task, UI integration, and file handling updates."
2a12fa6 "Add MeteorFolderDialog component for displaying decoded satellite folder images; integrate with FileBrowser and enhance folder data handling."
3bda6d1 "Remove redundant drawer toggle logic in E2E tests; replace with wait and force-click for improved stability and simplicity."
c48cfe8 "Ensure drawer is opened before interacting with navigation links in E2E tests to improve test stability."
124982c "Set process names for background tasks using setproctitle; fallback handling for missing dependency."
e967f42 "Add wait logic for closing dialogs across E2E tests to improve stability and prevent flaky behavior."
5815610 "Add wait logic for closing dialogs in navigation E2E tests to improve stability and prevent flaky behavior."
c432f43 "Refactor tasks popover layout: add sticky header, make body scrollable, and enhance flexbox structure for better usability."
5058740 "Introduce TLE synchronization as a background task; enforce singleton execution, integrate progress tracking, and refactor related logic for consistency."
87e93b7 "Add 'Actions' column with edit functionality to monitored satellites table."
1b4e78b "Refactor transmitter selection logic across dialogs; add safe value handling, remove loading overlays, and streamline async satellite fetching."
cb6ff50 Remove redundant decoder error handling and UI updates; streamline event dispatch and backend logic.
504e4f1 Prevent decoder-stats from being emitted to the UI; restrict to internal PerformanceMonitor use only.
8151983 Remove excessive debug logging from observation form and satellite selector for cleaner and more maintainable code.
1aff4c9 Remove excessive debug logging from satellite selector for cleaner and more efficient code.
cfbe13b Add debug logging for observation form and satellite selector state changes to aid in troubleshooting and improve visibility.
8be3272 "Refactor Docker configuration: consolidate Avahi mDNS setup, simplify ignore rules, and improve documentation for host vs. bridge network modes."
92c59cb "Add mDNS support via Avahi in Docker setup; configure D-Bus and Avahi services in container startup script."
8483c9a "Add SoapySDR discovery and monitoring tasks with mDNS support; integrate Socket.IO updates and thread-safe server management."
106b08b "Optimize satellite tracking test: refine marker checks, add satellite group selection, and increase loading wait time for improved reliability."
41a74b5 "Add manual center frequency input and auto-calculation toggle for SDR; improve transmitter frequency selection and UI clarity."
669818b "Enable auto-waterfall generation on stopRecording; remove UI snapshot dependency to streamline background task handling."
14d738e "Increase FFT sampling frames from 10 to 50 in waterfall generation to improve signal dynamics capture."
7591f3e "Close tasks popover and delay hiding icon after clearing all running tasks for smoother UI transition."
4ccd971 "Refactor file browser state handling logic to distinguish local-only actions from global file list updates; streamline socket event handling for improved clarity and efficiency."
bf61382 Add multiprocessing-based background task manager for long-running tasks with real-time progress updates. Integrate task examples, registry, and waterfall generation logic.
9df6637 "Refactor CRUD module imports and method calls to ensure consistent naming conventions for trackingstate and tlesources"
993df36 "Log waterfall generation decisions and improve clarity for auto-generation logic in RecorderManager"
23be8c3 "Add optional skip for automatic waterfall generation and integrate custom waterfall handling logic in backend and frontend"
fa842e1 "Update observation status banner: reposition cancel/stop button with absolute positioning for improved layout and clarity"
0606d62 "Redesign decoded packets delete confirmation dialog with improved styling, dynamic file details display, and enhanced UX clarity"
094055a "Add dynamic satellite visibility check and live countdown updates in observation status logic"
f19414c "Remove debug log statements from observation form dialog for cleaner console output"
28097f6 "Add location setup dialog and popover to alert users when ground station location is not configured; enhance location management logic and UI"
bcc8bdf "Redesign confirmation dialogs across components with improved styling, enhanced UX clarity, and dynamic content rendering"
79581d8 "Improve SDR sample rate selector with dynamic options based on SDR parameters and enhanced labeling logic"
b4b33a9 "Redesign SDR delete confirmation dialog with improved styling, dynamic SDR details display, and enhanced UX clarity"
913a572 "Add visual indicator and chip for recording status in file-table-view, including pulsing animation and labeled chip"
0ba8398 "Enhance satellite components with conditional rendering for markers, customizable delete button slots, and improved band labeling logic; update translation keys and defaults for consistency"
3db84c3 "Update file-table-view to classify GMSK decoder type as 'Packet' instead of 'Telemetry'"
e0251da "Refactor tracker process handling to ensure proper cleanup during shutdown and improve graceful exit logic"
567ac78 "Improve frequency shift processing by replacing exp with cos/sin for better precision and dtype handling"
5957a81 "Add input validation and phase continuity improvements to frequency shift processing"
c564bf7 "Preserve phase continuity in frequency shifting and add validation for invalid DC offset values in sample processing"
81d7b06 "Add frequency shift feature to baseband recordings, including frontend configuration and backend handling for signal centering"
b1f8198 Update server version to 0.1.82 in version.json

Pull the Docker image:

For AMD64 systems:

docker pull --platform linux/amd64 ghcr.io/sgoudelis/ground-station:0.1.83

For ARM64 systems (Raspberry Pi, etc):

docker pull --platform linux/arm64 ghcr.io/sgoudelis/ground-station:0.1.83

Or pull architecture-specific tags directly:

# AMD64
docker pull ghcr.io/sgoudelis/ground-station:0.1.83-amd64

# ARM64
docker pull ghcr.io/sgoudelis/ground-station:0.1.83-arm64

Run the container:

Option 1: With SoapySDR Remote Server Discovery (Recommended)

Uses host networking to enable mDNS discovery of SoapySDR remote servers:

# AMD64
docker run -d \
  --platform linux/amd64 \
  --network host \
  --name ground-station \
  --restart unless-stopped \
  --device=/dev/bus/usb \
  --privileged \
  -v /path/to/data:/app/backend/data \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.1.83

# ARM64 (Raspberry Pi, etc)
docker run -d \
  --platform linux/arm64 \
  --network host \
  --name ground-station \
  --restart unless-stopped \
  -v /dev:/dev \
  --privileged \
  -v /path/to/data:/app/backend/data \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.1.83

Option 2: Standard Bridge Mode (No SoapySDR Remote Discovery)

Uses standard bridge networking with port mapping:

# AMD64
docker run -d \
  --platform linux/amd64 \
  -p 7000:7000 \
  --name ground-station \
  --restart unless-stopped \
  --device=/dev/bus/usb \
  --privileged \
  -v /path/to/data:/app/backend/data \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.1.83

# ARM64 (Raspberry Pi, etc)
docker run -d \
  --platform linux/arm64 \
  -p 7000:7000 \
  --name ground-station \
  --restart unless-stopped \
  -v /dev:/dev \
  --privileged \
  -v /path/to/data:/app/backend/data \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.1.83

Note: Replace /path/to/data with your desired data directory path. Option 1 (host networking) is required for automatic mDNS discovery of SoapySDR remote servers. Option 2 works for local SDRs and all other features. For ARM64, using -v /dev:/dev ensures all USB devices are accessible.

After starting the container, access the web interface at http://<YOUR_HOST>:7000

Upgrading an existing container:

# Stop and remove the existing container
docker stop ground-station
docker rm ground-station

# Pull the new version
docker pull ghcr.io/sgoudelis/ground-station:0.1.83

# Run the container again (use the appropriate command above for your architecture)

Multi-arch support:

This image supports linux/amd64 and linux/arm64 platforms. Docker will automatically pull the correct architecture for your system.

Full Changelog: v0.1.82...v0.1.83