Skip to main content

A WebSocket application to tail files.

Project description

Tailsocket in action!

Tailsocket capture

You’ve set up your machine and you’re tweaking config files to get it just right, this last bit should do it… oh, it doesn’t? Weird, where’s that log again? Hmm, I know it’s in the history somewhere, or did I have it on screen/tmux? Which one? :/

Say no more! pip install tailsocket, run tailsocket-server, write the path to the log file once and let the logs come to you!

Ok, maybe I’m being a bit dramatic, but I’ve found this frustrating sometimes and seemed like a good use for WebSockets so I put this little project together using Tornado, asyncio and React.

Keep in mind Tailsocket can only read from files the owner of the process can read from.

Try it out at


  • Changing a tailed log file does not show confirmation, simply new log entries.
  • Application messages and errors show in the same context as log entries.


  • Globbing
  • Multiple log screens


  • v0.1.1 - Use the more performant pyinotify in Linux platforms instead of a raw select event loop.
  • v0.1 - Initial version.

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

tailsocket-0.1.1.tar.gz (569.5 kB view hashes)

Uploaded source

Built Distribution

tailsocket-0.1.1-py3-none-any.whl (570.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page