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.3.tar.gz (3.0 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.3-py3-none-any.whl (3.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mirsal-0.1.3.tar.gz
  • Upload date:
  • Size: 3.0 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.3.tar.gz
Algorithm Hash digest
SHA256 c38943988da9d9478d683c87cf8d5865b516ed2ba31e2be61928a469c61895c8
MD5 73f654cb232e3e777fd748133aa6b62e
BLAKE2b-256 4910033d525b3d4126a60d16924d823b9215778d793b2bd31f21573342618550

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mirsal-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 3.2 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 28fa80b7681a46291fe5ca7fa79c0e8620a10d58822eabcbf54c8a0c5e1831b0
MD5 beb8a3b07886e5334d6b0a44bb1b5313
BLAKE2b-256 7ed289541e217124db0918e78600723ee21770cb44095df349c79bea05d5d5e6

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