Ethos LogView

A cross-platform application for viewing and analyzing data from Ethos CSV log files.

Features

• Interactive Graphs: Beautiful, responsive graphs with Plotly
• Smooth Navigation: Pan with click-and-drag, zoom with scroll wheel
• Toggleable Data Series: Check/uncheck columns to show/hide data
• Time Axis Modes: Display time as Absolute or Relative format
• Dark Mode: Toggle between light and dark themes
• Grid Display: Optional grid lines
• Export: Save interactive graphs as HTML or PNG
• Previous Session: Remembers last loaded file and selected columns
• Insights: Built-in analyses for signal strength, voltage etc.
• Cross-platform: Windows, macOS, and Linux

Getting Started

Download a Pre-Built Executable

Visit the Releases page to download the latest executable for your platform:

• Windows: EthosLogViewer-Windows.zip
• macOS: EthosLogViewer-macOS.zip
• Linux: EthosLogViewer-Linux.zip

Extract the .zip and run the executable directly.

Usage

Basic Workflow

1. Load a CSV file: Click "Open CSV File" button
2. View file info: Check rows, columns, and time range at the top
3. Select columns: Check/uncheck columns from the large list to toggle visibility
4. Navigate the graph:
   • Scroll wheel: Zoom in/out
   • Click & drag: Pan around the graph
   • Toggle interaction mode: Settings > Interaction Mode (Pan or Zoom)
5. Customize display:
   • Settings > Time Axis Mode: Switch between Absolute and Relative time
   • Settings > Dark Mode: Toggle dark theme
   • View > Show Grid: Toggle grid lines
6. Reset view: View > Reset View to auto-scale both axes
7. Export: Save graphs as HTML or PNG
8. Insights (optional): Open Tools > Show Insights to run analyses and view results

For Developers

Building from Source

To build executables locally or create custom distributions:

1. Install dependencies: pip install -r requirements.txt
2. Build: python build.py
3. Output: Find built executables in the dist/ folder

License

This project is licensed under the GNU General Public License v3.0 (GPLv3). See the LICENSE file for details.

Disclaimer

This 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 arising from, out of, or in connection with the software or the use or other dealings in the software. Use this software at your own risk; it is not a safety-certified tool.