Skip to main content

📄 Live log viewer with Ngrok + Flask

Project description

📨 Mirsal

Mirsal (مرسال) is a lightweight CLI tool to view any log file live in your browser — from anywhere.

It starts a clean, scrollable log viewer server and exposes it via Ngrok with just one command.

مرسال: Arabic for "messenger" — your log updates, delivered.


🚀 Features

  • 🌐 Access your logs from anywhere via Ngrok
  • 📄 View live logs in a styled browser interface
  • 🔄 Auto-scrolls to the latest log lines
  • 🪶 Lightweight & fast (Flask + Ngrok under the hood)
  • ✅ No config needed — just run and go!

📦 Installation

pip install mirsal

🧪 Usage

mirsal <your_log_file>

Example:

mirsal slurm-12345.out

You’ll see:

🚀 Log viewer is live at: https://abc123.ngrok.io

Open that URL from your browser or mobile and watch logs live with automatic scrolling.


📜 License

MIT License


👨‍💻 Author

Bashar Talafha Built with love for developers who love clean logs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mirsal-0.1.2.tar.gz (2.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mirsal-0.1.2-py3-none-any.whl (3.1 kB view details)

Uploaded Python 3

File details

Details for the file mirsal-0.1.2.tar.gz.

File metadata

  • Download URL: mirsal-0.1.2.tar.gz
  • Upload date:
  • Size: 2.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.5

File hashes

Hashes for mirsal-0.1.2.tar.gz
Algorithm Hash digest
SHA256 10863ab06294b3736c8a65469840e91334c957b2c9dbe0855f22541167f5f483
MD5 62f1ef1385e5f5a7a565f68c945cacc5
BLAKE2b-256 c135e5f07a5e5cd04206e2544df3c4c8758a1a3ea2bffcc3295444921e2364db

See more details on using hashes here.

File details

Details for the file mirsal-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: mirsal-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 3.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.5

File hashes

Hashes for mirsal-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c08a5cc1c92a17fb0d3daaf0bd3ed35b6ffc8352cda5b9cb773960bda940ffc6
MD5 9d98ed2828e99afe05230f50351c3e66
BLAKE2b-256 17b135a42272cdfc3e882b1061ab1644b1e41fd3b8eb38a729ef7ff4fc9f0e57

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page