https://github.com/abra5umente/logninja

A fast, local, and powerful log viewer and parser, available in your browser.
https://github.com/abra5umente/logninja

logs logviewer opensource-apps parsing webapp

Last synced: 28 days ago
JSON representation

A fast, local, and powerful log viewer and parser, available in your browser.

• Host: GitHub
• URL: https://github.com/abra5umente/logninja
• Owner: abra5umente
• License: mit
• Created: 2025-08-14T11:25:57.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-11-03T06:59:44.000Z (7 months ago)
• Last Synced: 2025-11-03T07:07:04.466Z (7 months ago)
• Topics: logs, logviewer, opensource-apps, parsing, webapp
• Language: TypeScript
• Homepage: https://logninja.midgard-realm.xyz
• Size: 556 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# LogNinja

  

A fast, client‑side log viewer built with Vite + React + TypeScript. Drag and drop logs, filter by level/text/regex, browse a timeline, and export results. Designed to work entirely in the browser (no uploads).  

## Features

### UI & Layout

- **Three-column layout**: Controls on left, log viewer center, search/files on right

- **Clean initial state**: When no files are loaded, only the LogNinja logo and file browser are shown - all other UI elements appear after loading

- **Loading animations**: Smooth blur overlay with animated logo and spinner during file processing, with checkmark completion state

- **Global drag & drop**: Drop `.log/.txt/.csv` files anywhere on the window (UTF‑8/UTF‑16 BOM aware)

- **Modal interactions**: Settings sidebar, Airlock summary modal with ESC/click-outside to dismiss

### Log Viewing

- **High-performance virtual scrolling**: Handles millions of log entries smoothly

  - True infinite scrolling (no pagination)

  - Dynamic line wrapping with auto-height rows

  - **Wrap toggle**: Switch between single-line (horizontal scroll) and multi-line (auto-wrap) views

- **Multi-file support**: Load multiple log files with color-coded file indicators

- Basic log summary view on upload

- Row selection + Ctrl/Cmd+C to copy the full raw line

  - Selected rows persist across filter changes (auto-scrolls to keep selected row visible)

### Search & Filtering

- **Search**: plain text or regex, with match highlighting

  - Filter or highlight-only modes

  - Clear button to quickly reset search

  - Search presets for common queries

- **File filtering** (multi-file support):

  - Click a file → filter to show only that file's entries

  - Ctrl+Click files → multi-select mode (toggle multiple files on/off)

  - Click selected file again → deselect it (shows all files)

  - Visual feedback: selected files at full opacity, unselected dimmed

- **Level filtering**: ERROR, WARN, INFO, DEBUG, TRACE, UNKNOWN

  - Dynamically shows only levels present in loaded/filtered files

  - Click a level → filter to that level only

  - Ctrl+Click levels → multi-select mode (toggle multiple levels on/off)

  - Visual feedback: selected levels highlighted, unselected dimmed

- **Time range filtering** via timeline drill-down

- **Reset button**: Clears all filters (search, files, levels, time range) at once

### Timeline & Navigation

- **Hierarchical timeline with drill-down**: Navigate long time spans efficiently

  - Auto-detects starting level (Day for >24hr spans, Hour for ≤24hr)

  - Five levels: Day → Hour → 15min → Minute → Second

  - **Filters log view at every drill level** - not just at the deepest level

  - Incremental back navigation: "← Back to Hours", "← Back to Days", etc.

  - Card-based bin design with event counts inside each bin

  - Horizontal date/time labels for easy reading

  - Visual histogram showing log level breakdown for each time bin

  - Fixed statistics panel prevents layout shift during navigation

  - Optimized for large time spans (handles year+ log files without stack overflow)

### Bookmarks & Export

- Bookmarks: star lines and export them (CSV/Markdown includes "Bookmarked Lines")

  - **Bookmark-only view**: Show only bookmarked lines with configurable context (±1, 3, 5, or 10 lines)

- Export to CSV or Markdown

- Copy all filtered entries to clipboard

### Special Features

- **Airlock summary**: Auto-detected for Airlock Digital logs (modal with 21 metadata fields; Windows + Linux agents)

## Screenshots

Enhanced Airlock Digital log support:

  

Log Summary view:

  

Markdown Summary export view:

  

Settings with light/dark mode themes and accent colour picker:

  

Highlight search mode:

  

## Supported Formats (non‑exhaustive)

- ISO/RFC3339, `YYYY-MM-DD HH:mm:ss[.SSS|,SSS]`

- `YYYY/MM/DD HH:mm:ss[.SSS|,SSS]`

- DMY/MDY `dd/MM/yyyy HH:mm:ss[.SSS][ AM|PM]` (inferred)

- `dd Mon yyyy HH:mm:ss[.SSS]`

- Apache/Nginx combined: `dd/Mon/yyyy:HH:mm:ss Z`

- Redis: `PID:Role dd Mon yyyy HH:mm:ss.mmm  ...`

- Resque: `name: [LEVEL] : message`

- Ruby logger lines: `W, [ISO ts #pid] WARN -- : message`

- MongoDB structured JSON `{ "t": { "$date": ... }, "s": "I", "msg": ... }`

- MSI: `MSI (c|s) (...) [HH:mm:ss:SSS]` (time‑only; date inferred from file), or `[YYYY-MM-DD HH:mm:ss:SSS]`

## Getting Started

**Local Install**

- Requirements: Node.js 18+ and npm

- Install: `npm install`

- Dev: `npm run dev` (binds `0.0.0.0`), then visit `http://localhost:5173` or `http://yourip:5173` from network devices

- Build: `npm run build`

**Docker (recommended)**

- Clone repo

- Build the image: `docker build -t logninja .`

- Run the container: `docker run --rm -p 8080:80 logninja`

- Open http://localhost:8080

Alternatively, run the container using `docker run --rm -p 8080:80 alexschladetsch/logninja:latest`

 

## Keyboard & Tips

- `/` focuses search, `Ctrl/Cmd+K` opens command palette

- Click a row, then `Ctrl/Cmd+C` to copy its full raw text

- **Wrap toggle**: Enable for multi-line rows that adapt to content length; disable for single-line rows with horizontal scrolling

- **Timeline drill-down**: Click any bin to filter and explore deeper time ranges (Day → Hour → 15min → Minute → Second)

- **Multi-select filtering**:

  - `Ctrl/Cmd+Click` on files to select multiple files simultaneously

  - `Ctrl/Cmd+Click` on log levels to select multiple levels simultaneously

  - Click selected item again to deselect it

- **Global drag & drop**: Drop log files anywhere on the page, not just the browse button

- `ESC` or click outside to dismiss settings/Airlock modals

- Virtual scrolling works smoothly in both wrap and no-wrap modes for optimal performance

- Try and find the pizza-flavoured easter egg

## Privacy

The app runs fully in your browser; logs are not uploaded. Exports are generated locally.