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.1.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.1-py3-none-any.whl (3.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mirsal-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 5e12143425c232eead7937006a943ba8ce0f55da7d22de1cf1062a255e7f9628
MD5 2c10d100100940ea35fc2f902c1681df
BLAKE2b-256 0db301de8a5bdeb1dad5e2c12999ac8f47b353a8ce677eeea27c6a28d28205c9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mirsal-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 3.0 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4e542054bcba3ef88c36715e4c15cb2776a640262ef5bd40022eb6b227b9cd7a
MD5 479e8d83d4b61eb4c4cf91b3227c963f
BLAKE2b-256 88a22a9e27aac1d4e4a3783ca6cb118fb7d01460cf701e3ccd4f3cf33060a3de

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