Skip to main content

lib for gnu-screen: creates/close/list/log sessions, injects commands...

Project description

screenutils is a set of classes that should help handling gnu-screen windows.

Feel free to report any modification you made, the whole code source is available under the terms of the GPLv2.

Exemple usage

Exemple in a python console:

>>> from screenutils import list_screens, Screen
>>> list_screens()
>>> s= Screen("session1",True)
>>> # screen blink once
>>> # funky prompt should reduce logs lisibility so you should use sh or bash
>>> s.send_commands('bash')
>>> s.enable_logs()
>>> s.send_commands("df")
>>> print next(s.logs)
Filesystem           1K-blocks      Used Available Use% Mounted on
/dev/sda6             20161172   8084052  11052980  43% /
none                   1505916       304   1505612   1% /dev
none                   1512676       936   1511740   1% /dev/shm
none                   1512676       380   1512296   1% /var/run
none                   1512676         0   1512676   0% /var/lock
none                   1512676         0   1512676   0% /lib/init/rw
none                  20161172   8084052  11052980  43% /var/lib/ureadahead/debugfs
/dev/sda7            403567768 196284216 186783420  52% /home
>>> s.disable_logs()
>>> s = None
>>> s = Screen("session1")
>>> s.exists
>>> s2 = Screen("session2")
>>> s2.exists
>>> s2.initialize()
>>> list_screens()
[<Screen 'session2'>, <Screen 'session1'>]


You could install screenutils from github, by doing the following:

$ pip install git+

Or by just using the packages publicated at pypi, for instance with pip:

$ pip install screenutils


  • screens listing
  • screen session creation
  • screen session closing
  • screen code insertion
  • screen monitoring/logging
  • screen session sharing with unix users
    • to allow this feature, you will need to change some unixs rigths:
      • sudo chmod +s /usr/bin/screen
      • sudo chmod 755 /var/run/screen

Known issues

This may not work properly with bpython.


  • multi windows screen support

Project details

Download files

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

Files for screenutils, version
Filename, size File type Python version Upload date Hashes
Filename, size screenutils- (3.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page