[tor-commits] [nyx/master] Move panels into their own module

8 Mar 2016

commit fa3a3f0eb11eec7d5af69148f1fc1deff0f6d9bd
Author: Damian Johnson atagar@torproject.org
Date:   Tue Mar 8 09:40:12 2016 -0800
Move panels into their own module
Now that we're done overhauling the panels lets move them into their own
    module. They've all had the same naming convention ('foo_panel.py') so this
    just makes the grouping more explicit.
---
 nyx/__init__.py         |   5 -
 nyx/config_panel.py     | 357 -----------------------
 nyx/connection_panel.py | 706 ---------------------------------------------
 nyx/controller.py       |  25 +-
 nyx/graph_panel.py      | 753 ------------------------------------------------
 nyx/header_panel.py     | 496 -------------------------------
 nyx/log_panel.py        | 454 -----------------------------
 nyx/menu/actions.py     |   8 +-
 nyx/panel/__init__.py   |  11 +
 nyx/panel/config.py     | 357 +++++++++++++++++++++++
 nyx/panel/connection.py | 706 +++++++++++++++++++++++++++++++++++++++++++++
 nyx/panel/graph.py      | 753 ++++++++++++++++++++++++++++++++++++++++++++++++
 nyx/panel/header.py     | 496 +++++++++++++++++++++++++++++++
 nyx/panel/log.py        | 454 +++++++++++++++++++++++++++++
 nyx/panel/torrc.py      | 171 +++++++++++
 nyx/torrc_panel.py      | 171 -----------
 nyx/util/log.py         |   2 +-
 setup.py                |   2 +-
 18 files changed, 2967 insertions(+), 2960 deletions(-)

diff --git a/nyx/__init__.py b/nyx/__init__.py
index 4d58435..25da9dd 100644
--- a/nyx/__init__.py
+++ b/nyx/__init__.py
@@ -14,14 +14,9 @@ __license__ = 'GPLv3'
__all__ = [
   'arguments',
-  'config_panel',
-  'connection_panel',
   'controller',
-  'header_panel',
-  'log_panel',
   'popups',
   'starter',
-  'torrc_panel',
 ]
diff --git a/nyx/config_panel.py b/nyx/config_panel.py
deleted file mode 100644
index 2352fe7..0000000
--- a/nyx/config_panel.py
+++ /dev/null
@@ -1,357 +0,0 @@
-"""
-Panel presenting the configuration state for tor or nyx. Options can be edited
-and the resulting configuration files saved.
-"""
-
-import curses
-import os
-
-import nyx.controller
-import nyx.popups
-
-import stem.control
-import stem.manual
-
-from nyx.util import DATA_DIR, panel, tor_controller, ui_tools
-
-from stem.util import conf, enum, log, str_tools
-
-SortAttr = enum.Enum('NAME', 'VALUE', 'VALUE_TYPE', 'CATEGORY', 'USAGE', 'SUMMARY', 'DESCRIPTION', 'MAN_PAGE_ENTRY', 'IS_SET')
-
-DETAILS_HEIGHT = 8
-NAME_WIDTH = 25
-VALUE_WIDTH = 15
-
-
-def conf_handler(key, value):
-  if key == 'features.config.order':
-    return conf.parse_enum_csv(key, value[0], SortAttr, 3)
-
-
-CONFIG = conf.config_dict('nyx', {
-  'attr.config.category_color': {},
-  'attr.config.sort_color': {},
-  'features.config.order': [SortAttr.MAN_PAGE_ENTRY, SortAttr.NAME, SortAttr.IS_SET],
-  'features.config.state.showPrivateOptions': False,
-  'features.config.state.showVirtualOptions': False,
-}, conf_handler)
-
-
-class ConfigEntry(object):
-  """
-  Configuration option presented in the panel.
-
-  :var str name: name of the configuration option
-  :var str value_type: type of value
-  :var stem.manual.ConfigOption manual: manual information about the option
-  """
-
-  def __init__(self, name, value_type, manual):
-    self.name = name
-    self.value_type = value_type
-    self.manual = manual.config_options.get(name, stem.manual.ConfigOption(name))
-    self._index = manual.config_options.keys().index(name) if name in manual.config_options else 99999
-
-  def value(self):
-    """
-    Provides the value of this configuration option.
-
-    :returns: **str** representation of the current config value
-    """
-
-    values = tor_controller().get_conf(self.name, [], True)
-
-    if not values:
-      return '<none>'
-    elif self.value_type == 'Boolean' and values[0] in ('0', '1'):
-      return 'False' if values[0] == '0' else 'True'
-    elif self.value_type == 'DataSize' and values[0].isdigit():
-      return str_tools.size_label(int(values[0]))
-    elif self.value_type == 'TimeInterval' and values[0].isdigit():
-      return str_tools.time_label(int(values[0]), is_long = True)
-    else:
-      return ', '.join(values)
-
-  def is_set(self):
-    """
-    Checks if the configuration option has a custom value.
-
-    :returns: **True** if the option has a custom value, **False** otherwise
-    """
-
-    return tor_controller().is_set(self.name, False)
-
-  def sort_value(self, attr):
-    """
-    Provides a heuristic for sorting by a given value.
-
-    :param SortAttr attr: sort attribute to provide a heuristic for
-
-    :returns: comparable value for sorting
-    """
-
-    if attr == SortAttr.CATEGORY:
-      return self.manual.category
-    elif attr == SortAttr.NAME:
-      return self.name
-    elif attr == SortAttr.VALUE:
-      return self.value()
-    elif attr == SortAttr.VALUE_TYPE:
-      return self.value_type
-    elif attr == SortAttr.USAGE:
-      return self.manual.usage
-    elif attr == SortAttr.SUMMARY:
-      return self.manual.summary
-    elif attr == SortAttr.DESCRIPTION:
-      return self.manual.description
-    elif attr == SortAttr.MAN_PAGE_ENTRY:
-      return self._index
-    elif attr == SortAttr.IS_SET:
-      return not self.is_set()
-
-
-class ConfigPanel(panel.Panel):
-  """
-  Editor for tor's configuration.
-  """
-
-  def __init__(self, stdscr):
-    panel.Panel.__init__(self, stdscr, 'configuration', 0)
-
-    self._contents = []
-    self._scroller = ui_tools.Scroller(True)
-    self._sort_order = CONFIG['features.config.order']
-    self._show_all = False  # show all options, or just the important ones
-
-    cached_manual_path = os.path.join(DATA_DIR, 'manual')
-
-    if os.path.exists(cached_manual_path):
-      manual = stem.manual.Manual.from_cache(cached_manual_path)
-    else:
-      try:
-        manual = stem.manual.Manual.from_man()
-
-        try:
-          manual.save(cached_manual_path)
-        except IOError as exc:
-          log.debug("Unable to cache manual information to '%s'. This is fine, but means starting Nyx takes a little longer than usual: " % (cached_manual_path, exc))
-      except IOError as exc:
-        log.debug("Unable to use 'man tor' to get information about config options (%s), using bundled information instead" % exc)
-        manual = stem.manual.Manual.from_cache()
-
-    try:
-      for line in tor_controller().get_info('config/names').splitlines():
-        # Lines of the form "<option> <type>[ <documentation>]". Documentation
-        # was apparently only in old tor versions like 0.2.1.25.
-
-        if ' ' not in line:
-          continue
-
-        line_comp = line.split()
-        name, value_type = line_comp[0], line_comp[1]
-
-        # skips private and virtual entries if not configured to show them
-
-        if name.startswith('__') and not CONFIG['features.config.state.showPrivateOptions']:
-          continue
-        elif value_type == 'Virtual' and not CONFIG['features.config.state.showVirtualOptions']:
-          continue
-
-        self._contents.append(ConfigEntry(name, value_type, manual))
-
-      self._contents = sorted(self._contents, key = lambda entry: [entry.sort_value(field) for field in self._sort_order])
-    except stem.ControllerError as exc:
-      log.warn('Unable to determine the configuration options tor supports: %s' % exc)
-
-  def show_sort_dialog(self):
-    """
-    Provides the dialog for sorting our configuration options.
-    """
-
-    sort_colors = dict([(attr, CONFIG['attr.config.sort_color'].get(attr, 'white')) for attr in SortAttr])
-    results = nyx.popups.show_sort_dialog('Config Option Ordering:', SortAttr, self._sort_order, sort_colors)
-
-    if results:
-      self._sort_order = results
-      self._contents = sorted(self._contents, key = lambda entry: [entry.sort_value(field) for field in self._sort_order])
-
-  def show_write_dialog(self):
-    """
-    Confirmation dialog for saving tor's configuration.
-    """
-
-    selection, controller = 1, tor_controller()
-    config_text = controller.get_info('config-text', None)
-    config_lines = config_text.splitlines() if config_text else []
-
-    with nyx.popups.popup_window(len(config_lines) + 2) as (popup, width, height):
-      if not popup or height <= 2:
-        return
-
-      while True:
-        height, width = popup.get_preferred_size()  # allow us to be resized
-        popup.win.erase()
-
-        for i, full_line in enumerate(config_lines):
-          line = str_tools.crop(full_line, width - 2)
-          option, arg = line.split(' ', 1) if ' ' in line else (line, '')
-
-          popup.addstr(i + 1, 1, option, curses.A_BOLD, 'green')
-          popup.addstr(i + 1, len(option) + 2, arg, curses.A_BOLD, 'cyan')
-
-        x = width - 16
-
-        for i, option in enumerate(['Save', 'Cancel']):
-          x = popup.addstr(height - 2, x, '[')
-          x = popup.addstr(height - 2, x, option, curses.A_BOLD, curses.A_STANDOUT if i == selection else curses.A_NORMAL)
-          x = popup.addstr(height - 2, x, '] ')
-
-        popup.win.box()
-        popup.addstr(0, 0, 'Torrc to save:', curses.A_STANDOUT)
-        popup.win.refresh()
-
-        key = nyx.controller.get_controller().key_input()
-
-        if key.match('left'):
-          selection = max(0, selection - 1)
-        elif key.match('right'):
-          selection = min(1, selection + 1)
-        elif key.is_selection():
-          if selection == 0:
-            try:
-              controller.save_conf()
-              nyx.popups.show_msg('Saved configuration to %s' % controller.get_info('config-file', '<unknown>'), 2)
-            except IOError as exc:
-              nyx.popups.show_msg('Unable to save configuration (%s)' % exc.strerror, 2)
-
-          break
-        elif key.match('esc'):
-          break  # esc - cancel
-
-  def handle_key(self, key):
-    if key.is_scroll():
-      page_height = self.get_preferred_size()[0] - DETAILS_HEIGHT
-      is_changed = self._scroller.handle_key(key, self._get_config_options(), page_height)
-
-      if is_changed:
-        self.redraw(True)
-    elif key.is_selection():
-      selection = self._scroller.get_cursor_selection(self._get_config_options())
-      initial_value = selection.value() if selection.is_set() else ''
-      new_value = nyx.popups.input_prompt('%s Value (esc to cancel): ' % selection.name, initial_value)
-
-      if new_value != initial_value:
-        try:
-          if selection.value_type == 'Boolean':
-            # if the value's a boolean then allow for 'true' and 'false' inputs
-
-            if new_value.lower() == 'true':
-              new_value = '1'
-            elif new_value.lower() == 'false':
-              new_value = '0'
-          elif selection.value_type == 'LineList':
-            new_value = new_value.split(',')  # set_conf accepts list inputs
-
-          tor_controller().set_conf(selection.name, new_value)
-          self.redraw(True)
-        except Exception as exc:
-          nyx.popups.show_msg('%s (press any key)' % exc)
-    elif key.match('a'):
-      self._show_all = not self._show_all
-      self.redraw(True)
-    elif key.match('s'):
-      self.show_sort_dialog()
-    elif key.match('w'):
-      self.show_write_dialog()
-    else:
-      return False
-
-    return True
-
-  def get_help(self):
-    return [
-      ('up arrow', 'scroll up a line', None),
-      ('down arrow', 'scroll down a line', None),
-      ('page up', 'scroll up a page', None),
-      ('page down', 'scroll down a page', None),
-      ('enter', 'edit configuration option', None),
-      ('w', 'write torrc', None),
-      ('a', 'toggle filtering', None),
-      ('s', 'sort ordering', None),
-    ]
-
-  def draw(self, width, height):
-    contents = self._get_config_options()
-    selection = self._scroller.get_cursor_selection(contents)
-    scroll_location = self._scroller.get_scroll_location(contents, height - DETAILS_HEIGHT)
-    is_scrollbar_visible = len(contents) > height - DETAILS_HEIGHT
-
-    if selection is not None:
-      self._draw_selection_details(selection, width)
-
-    if self.is_title_visible():
-      hidden_msg = "press 'a' to hide most options" if self._show_all else "press 'a' to show all options"
-      self.addstr(0, 0, 'Tor Configuration (%s):' % hidden_msg, curses.A_STANDOUT)
-
-    scroll_offset = 1
-
-    if is_scrollbar_visible:
-      scroll_offset = 3
-      self.add_scroll_bar(scroll_location, scroll_location + height - DETAILS_HEIGHT, len(contents), DETAILS_HEIGHT)
-
-      if selection is not None:
-        self.addch(DETAILS_HEIGHT - 1, 1, curses.ACS_TTEE)
-
-    # Description column can grow up to eighty characters. After that any extra
-    # space goes to the value.
-
-    description_width = max(0, width - scroll_offset - NAME_WIDTH - VALUE_WIDTH - 2)
-
-    if description_width > 80:
-      value_width = VALUE_WIDTH + (description_width - 80)
-      description_width = 80
-    else:
-      value_width = VALUE_WIDTH
-
-    for i, entry in enumerate(contents[scroll_location:]):
-      attr = nyx.util.ui_tools.get_color(CONFIG['attr.config.category_color'].get(entry.manual.category, 'white'))
-      attr |= curses.A_BOLD if entry.is_set() else curses.A_NORMAL
-      attr |= curses.A_STANDOUT if entry == selection else curses.A_NORMAL
-
-      option_label = str_tools.crop(entry.name, NAME_WIDTH).ljust(NAME_WIDTH + 1)
-      value_label = str_tools.crop(entry.value(), value_width).ljust(value_width + 1)
-      summary_label = str_tools.crop(entry.manual.summary, description_width).ljust(description_width)
-
-      self.addstr(DETAILS_HEIGHT + i, scroll_offset, option_label + value_label + summary_label, attr)
-
-      if DETAILS_HEIGHT + i >= height:
-        break
-
-  def _get_config_options(self):
-    return self._contents if self._show_all else filter(lambda entry: stem.manual.is_important(entry.name) or entry.is_set(), self._contents)
-
-  def _draw_selection_details(self, selection, width):
-    """
-    Shows details of the currently selected option.
-    """
-
-    description = 'Description: %s' % (selection.manual.description)
-    attr = ', '.join(('custom' if selection.is_set() else 'default', selection.value_type, 'usage: %s' % selection.manual.usage))
-    selected_color = CONFIG['attr.config.category_color'].get(selection.manual.category, 'white')
-    ui_tools.draw_box(self, 0, 0, width, DETAILS_HEIGHT)
-
-    self.addstr(1, 2, '%s (%s Option)' % (selection.name, selection.manual.category), curses.A_BOLD, selected_color)
-    self.addstr(2, 2, 'Value: %s (%s)' % (selection.value(), str_tools.crop(attr, width - len(selection.value()) - 13)), curses.A_BOLD, selected_color)
-
-    for i in range(DETAILS_HEIGHT - 4):
-      if not description:
-        break  # done writing description
-
-      line, description = description.split('\n', 1) if '\n' in description else (description, '')
-
-      if i < DETAILS_HEIGHT - 5:
-        line, remainder = str_tools.crop(line, width - 3, 4, 4, str_tools.Ending.HYPHEN, True)
-        description = '  ' + remainder.strip() + description
-        self.addstr(3 + i, 2, line, curses.A_BOLD, selected_color)
-      else:
-        self.addstr(3 + i, 2, str_tools.crop(line, width - 3, 4, 4), curses.A_BOLD, selected_color)
diff --git a/nyx/connection_panel.py b/nyx/connection_panel.py
deleted file mode 100644
index e28f531..0000000
--- a/nyx/connection_panel.py
+++ /dev/null
@@ -1,706 +0,0 @@
-"""
-Listing of the currently established connections tor has made.
-"""
-
-import re
-import time
-import collections
-import curses
-import itertools
-import threading
-
-import nyx.popups
-import nyx.util.tracker
-import nyx.util.ui_tools
-
-from nyx.util import panel, tor_controller, ui_tools
-
-from stem.control import Listener
-from stem.util import datetime_to_unix, conf, connection, enum, str_tools
-
-try:
-  # added in python 3.2
-  from functools import lru_cache
-except ImportError:
-  from stem.util.lru_cache import lru_cache
-
-# height of the detail panel content, not counting top and bottom border
-
-DETAILS_HEIGHT = 7
-
-EXIT_USAGE_WIDTH = 15
-UPDATE_RATE = 5  # rate in seconds at which we refresh
-
-# cached information from our last _update() call
-
-LAST_RETRIEVED_HS_CONF = None
-LAST_RETRIEVED_CIRCUITS = None
-
-# Connection Categories:
-#   Inbound      Relay connection, coming to us.
-#   Outbound     Relay connection, leaving us.
-#   Exit         Outbound relay connection leaving the Tor network.
-#   Hidden       Connections to a hidden service we're providing.
-#   Socks        Socks connections for applications using Tor.
-#   Circuit      Circuits our tor client has created.
-#   Directory    Fetching tor consensus information.
-#   Control      Tor controller (nyx, vidalia, etc).
-
-Category = enum.Enum('INBOUND', 'OUTBOUND', 'EXIT', 'HIDDEN', 'SOCKS', 'CIRCUIT', 'DIRECTORY', 'CONTROL')
-SortAttr = enum.Enum('CATEGORY', 'UPTIME', 'IP_ADDRESS', 'PORT', 'FINGERPRINT', 'NICKNAME', 'COUNTRY')
-LineType = enum.Enum('CONNECTION', 'CIRCUIT_HEADER', 'CIRCUIT')
-
-Line = collections.namedtuple('Line', [
-  'entry',
-  'line_type',
-  'connection',
-  'circuit',
-  'fingerprint',
-  'nickname',
-  'locale',
-])
-
-
-def conf_handler(key, value):
-  if key == 'features.connection.order':
-    return conf.parse_enum_csv(key, value[0], SortAttr, 3)
-
-
-CONFIG = conf.config_dict('nyx', {
-  'attr.connection.category_color': {},
-  'attr.connection.sort_color': {},
-  'features.connection.resolveApps': True,
-  'features.connection.order': [SortAttr.CATEGORY, SortAttr.IP_ADDRESS, SortAttr.UPTIME],
-  'features.connection.showIps': True,
-}, conf_handler)
-
-
-class Entry(object):
-  @staticmethod
-  @lru_cache()
-  def from_connection(connection):
-    return ConnectionEntry(connection)
-
-  @staticmethod
-  @lru_cache()
-  def from_circuit(circuit):
-    return CircuitEntry(circuit)
-
-  def get_lines(self):
-    """
-    Provides individual lines of connection information.
-
-    :returns: **list** of **ConnectionLine** concerning this entry
-    """
-
-    raise NotImplementedError('should be implemented by subclasses')
-
-  def get_type(self):
-    """
-    Provides our best guess at the type of connection this is.
-
-    :returns: **Category** for the connection's type
-    """
-
-    raise NotImplementedError('should be implemented by subclasses')
-
-  def is_private(self):
-    """
-    Checks if information about this endpoint should be scrubbed. Relaying
-    etiquette (and wiretapping laws) say these are bad things to look at so
-    DON'T CHANGE THIS UNLESS YOU HAVE A DAMN GOOD REASON!
-
-    :returns: **bool** indicating if connection information is sensive or not
-    """
-
-    raise NotImplementedError('should be implemented by subclasses')
-
-  def sort_value(self, attr):
-    """
-    Provides a heuristic for sorting by a given value.
-
-    :param SortAttr attr: sort attribute to provide a heuristic for
-
-    :returns: comparable value for sorting
-    """
-
-    line = self.get_lines()[0]
-    at_end = 'z' * 20
-
-    if attr == SortAttr.IP_ADDRESS:
-      if self.is_private():
-        return 255 ** 4  # orders at the end
-
-      ip_value = 0
-
-      for octet in line.connection.remote_address.split('.'):
-        ip_value = ip_value * 255 + int(octet)
-
-      return ip_value * 65536 + line.connection.remote_port
-    elif attr == SortAttr.PORT:
-      return line.connection.remote_port
-    elif attr == SortAttr.FINGERPRINT:
-      return line.fingerprint if line.fingerprint else at_end
-    elif attr == SortAttr.NICKNAME:
-      return line.nickname if line.nickname else at_end
-    elif attr == SortAttr.CATEGORY:
-      return Category.index_of(self.get_type())
-    elif attr == SortAttr.UPTIME:
-      return line.connection.start_time
-    elif attr == SortAttr.COUNTRY:
-      return line.locale if (line.locale and not self.is_private()) else at_end
-    else:
-      return ''
-
-
-class ConnectionEntry(Entry):
-  def __init__(self, connection):
-    self._connection = connection
-
-  @lru_cache()
-  def get_lines(self):
-    fingerprint, nickname, locale = None, None, None
-
-    if self.get_type() in (Category.OUTBOUND, Category.CIRCUIT, Category.DIRECTORY, Category.EXIT):
-      fingerprint = nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(self._connection.remote_address).get(self._connection.remote_port)
-
-      if fingerprint:
-        nickname = nyx.util.tracker.get_consensus_tracker().get_relay_nickname(fingerprint)
-        locale = tor_controller().get_info('ip-to-country/%s' % self._connection.remote_address, None)
-
-    return [Line(self, LineType.CONNECTION, self._connection, None, fingerprint, nickname, locale)]
-
-  @lru_cache()
-  def get_type(self):
-    controller = tor_controller()
-
-    if self._connection.local_port in controller.get_ports(Listener.OR, []):
-      return Category.INBOUND
-    elif self._connection.local_port in controller.get_ports(Listener.DIR, []):
-      return Category.INBOUND
-    elif self._connection.local_port in controller.get_ports(Listener.SOCKS, []):
-      return Category.SOCKS
-    elif self._connection.local_port in controller.get_ports(Listener.CONTROL, []):
-      return Category.CONTROL
-
-    if LAST_RETRIEVED_HS_CONF:
-      for hs_config in LAST_RETRIEVED_HS_CONF.values():
-        if self._connection.remote_port == hs_config['HiddenServicePort']:
-          return Category.HIDDEN
-
-    fingerprint = nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(self._connection.remote_address).get(self._connection.remote_port)
-
-    if fingerprint and LAST_RETRIEVED_CIRCUITS:
-      for circ in LAST_RETRIEVED_CIRCUITS:
-        if circ.path and len(circ.path) == 1 and circ.path[0][0] == fingerprint and circ.status == 'BUILT':
-          return Category.DIRECTORY  # one-hop circuit to retrieve directory information
-    else:
-      # not a known relay, might be an exit connection
-
-      exit_policy = controller.get_exit_policy(None)
-
-      if exit_policy and exit_policy.can_exit_to(self._connection.remote_address, self._connection.remote_port):
-        return Category.EXIT
-
-    return Category.OUTBOUND
-
-  @lru_cache()
-  def is_private(self):
-    if not CONFIG['features.connection.showIps']:
-      return True
-
-    if self.get_type() == Category.INBOUND:
-      controller = tor_controller()
-
-      if controller.is_user_traffic_allowed().inbound:
-        return len(nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(self._connection.remote_address)) == 0
-    elif self.get_type() == Category.EXIT:
-      # DNS connections exiting us aren't private (since they're hitting our
-      # resolvers). Everything else is.
-
-      return not (self._connection.remote_port == 53 and self._connection.protocol == 'udp')
-
-    return False  # for everything else this isn't a concern
-
-
-class CircuitEntry(Entry):
-  def __init__(self, circuit):
-    self._circuit = circuit
-
-  @lru_cache()
-  def get_lines(self):
-    def line(fingerprint, line_type):
-      address, port, nickname, locale = '0.0.0.0', 0, None, None
-      consensus_tracker = nyx.util.tracker.get_consensus_tracker()
-
-      if fingerprint is not None:
-        address, port = consensus_tracker.get_relay_address(fingerprint, ('192.168.0.1', 0))
-        nickname = consensus_tracker.get_relay_nickname(fingerprint)
-        locale = tor_controller().get_info('ip-to-country/%s' % address, None)
-
-      connection = nyx.util.tracker.Connection(datetime_to_unix(self._circuit.created), False, '127.0.0.1', 0, address, port, 'tcp', False)
-      return Line(self, line_type, connection, self._circuit, fingerprint, nickname, locale)
-
-    header_line = line(self._circuit.path[-1][0] if self._circuit.status == 'BUILT' else None, LineType.CIRCUIT_HEADER)
-    return [header_line] + [line(fp, LineType.CIRCUIT) for fp, _ in self._circuit.path]
-
-  def get_type(self):
-    return Category.CIRCUIT
-
-  def is_private(self):
-    return False
-
-
-class ConnectionPanel(panel.Panel, threading.Thread):
-  """
-  Listing of connections tor is making, with information correlated against
-  the current consensus and other data sources.
-  """
-
-  def __init__(self, stdscr):
-    panel.Panel.__init__(self, stdscr, 'connections', 0)
-    threading.Thread.__init__(self)
-    self.setDaemon(True)
-
-    self._scroller = ui_tools.Scroller(True)
-    self._entries = []            # last fetched display entries
-    self._show_details = False    # presents the details panel if true
-    self._sort_order = CONFIG['features.connection.order']
-
-    self._last_resource_fetch = -1  # timestamp of the last ConnectionResolver results used
-
-    self._pause_condition = threading.Condition()
-    self._halt = False  # terminates thread if true
-
-    # Tracks exiting port and client country statistics
-
-    self._client_locale_usage = {}
-    self._exit_port_usage = {}
-    self._counted_connections = set()
-
-    # If we're a bridge and been running over a day then prepopulates with the
-    # last day's clients.
-
-    bridge_clients = tor_controller().get_info('status/clients-seen', None)
-
-    if bridge_clients:
-      # Response has a couple arguments...
-      # TimeStarted="2011-08-17 15:50:49" CountrySummary=us=16,de=8,uk=8
-
-      country_summary = None
-
-      for line in bridge_clients.split():
-        if line.startswith('CountrySummary='):
-          country_summary = line[15:]
-          break
-
-      if country_summary:
-        for entry in country_summary.split(','):
-          if re.match('^..=[0-9]+$', entry):
-            locale, count = entry.split('=', 1)
-            self._client_locale_usage[locale] = int(count)
-
-  def show_sort_dialog(self):
-    """
-    Provides a dialog for sorting our connections.
-    """
-
-    sort_colors = dict([(attr, CONFIG['attr.connection.sort_color'].get(attr, 'white')) for attr in SortAttr])
-    results = nyx.popups.show_sort_dialog('Connection Ordering:', SortAttr, self._sort_order, sort_colors)
-
-    if results:
-      self._sort_order = results
-      self._entries = sorted(self._entries, key = lambda entry: [entry.sort_value(attr) for attr in self._sort_order])
-
-  def handle_key(self, key):
-    user_traffic_allowed = tor_controller().is_user_traffic_allowed()
-
-    if key.is_scroll():
-      page_height = self.get_preferred_size()[0] - 1
-
-      if self._show_details:
-        page_height -= (DETAILS_HEIGHT + 1)
-
-      lines = list(itertools.chain.from_iterable([entry.get_lines() for entry in self._entries]))
-      is_changed = self._scroller.handle_key(key, lines, page_height)
-
-      if is_changed:
-        self.redraw(True)
-    elif key.is_selection():
-      self._show_details = not self._show_details
-      self.redraw(True)
-    elif key.match('s'):
-      self.show_sort_dialog()
-    elif key.match('r'):
-      connection_tracker = nyx.util.tracker.get_connection_tracker()
-      options = ['auto'] + list(connection.Resolver) + list(nyx.util.tracker.CustomResolver)
-
-      resolver = connection_tracker.get_custom_resolver()
-      selected_index = 0 if resolver is None else options.index(resolver)
-      selection = nyx.popups.show_menu('Connection Resolver:', options, selected_index)
-
-      if selection != -1:
-        connection_tracker.set_custom_resolver(None if selection == 0 else options[selection])
-    elif key.match('d'):
-      self.set_title_visible(False)
-      self.redraw(True)
-      entries = self._entries
-
-      while True:
-        lines = list(itertools.chain.from_iterable([entry.get_lines() for entry in entries]))
-        selection = self._scroller.get_cursor_selection(lines)
-
-        if not selection:
-          break
-
-        def is_close_key(key):
-          return key.is_selection() or key.match('d') or key.match('left') or key.match('right')
-
-        color = CONFIG['attr.connection.category_color'].get(selection.entry.get_type(), 'white')
-        key = nyx.popups.show_descriptor_popup(selection.fingerprint, color, self.max_x, is_close_key)
-
-        if not key or key.is_selection() or key.match('d'):
-          break  # closes popup
-        elif key.match('left'):
-          self.handle_key(panel.KeyInput(curses.KEY_UP))
-        elif key.match('right'):
-          self.handle_key(panel.KeyInput(curses.KEY_DOWN))
-
-      self.set_title_visible(True)
-      self.redraw(True)
-    elif key.match('c') and user_traffic_allowed.inbound:
-      nyx.popups.show_count_dialog('Client Locales', self._client_locale_usage)
-    elif key.match('e') and user_traffic_allowed.outbound:
-      counts = {}
-      key_width = max(map(len, self._exit_port_usage.keys()))
-
-      for k, v in self._exit_port_usage.items():
-        usage = connection.port_usage(k)
-
-        if usage:
-          k = k.ljust(key_width + 3) + usage.ljust(EXIT_USAGE_WIDTH)
-
-        counts[k] = v
-
-      nyx.popups.show_count_dialog('Exiting Port Usage', counts)
-    else:
-      return False
-
-    return True
-
-  def run(self):
-    """
-    Keeps connections listing updated, checking for new entries at a set rate.
-    """
-
-    last_ran = -1
-
-    while not self._halt:
-      if self.is_paused() or not tor_controller().is_alive() or (time.time() - last_ran) < UPDATE_RATE:
-        with self._pause_condition:
-          if not self._halt:
-            self._pause_condition.wait(0.2)
-
-        continue  # done waiting, try again
-
-      self._update()
-      self.redraw(True)
-
-      # If this is our first run then fill in our fingerprint tracker. This
-      # requires fetching all the router status entries which takes a few
-      # seconds, so best done when we're finished with the rest of the first
-      # iteration to hide the lag.
-
-      if last_ran == -1:
-        nyx.util.tracker.get_consensus_tracker().update(tor_controller().get_network_statuses([]))
-
-      last_ran = time.time()
-
-  def get_help(self):
-    resolver = nyx.util.tracker.get_connection_tracker().get_custom_resolver()
-    user_traffic_allowed = tor_controller().is_user_traffic_allowed()
-
-    options = [
-      ('up arrow', 'scroll up a line', None),
-      ('down arrow', 'scroll down a line', None),
-      ('page up', 'scroll up a page', None),
-      ('page down', 'scroll down a page', None),
-      ('enter', 'show connection details', None),
-      ('d', 'raw consensus descriptor', None),
-      ('s', 'sort ordering', None),
-      ('r', 'connection resolver', 'auto' if resolver is None else resolver),
-    ]
-
-    if user_traffic_allowed.inbound:
-      options.append(('c', 'client locale usage summary', None))
-
-    if user_traffic_allowed.outbound:
-      options.append(('e', 'exit port usage summary', None))
-
-    return options
-
-  def draw(self, width, height):
-    controller = tor_controller()
-    entries = self._entries
-
-    lines = list(itertools.chain.from_iterable([entry.get_lines() for entry in entries]))
-    selected = self._scroller.get_cursor_selection(lines)
-
-    if self.is_paused():
-      current_time = self.get_pause_time()
-    elif not controller.is_alive():
-      current_time = controller.connection_time()
-    else:
-      current_time = time.time()
-
-    is_showing_details = self._show_details and selected
-    details_offset = DETAILS_HEIGHT + 1 if is_showing_details else 0
-
-    is_scrollbar_visible = len(lines) > height - details_offset - 1
-    scroll_offset = 2 if is_scrollbar_visible else 0
-    scroll_location = self._scroller.get_scroll_location(lines, height - details_offset - 1)
-
-    if self.is_title_visible():
-      self._draw_title(entries, self._show_details)
-
-    if is_showing_details:
-      self._draw_details(selected, width, is_scrollbar_visible)
-
-    if is_scrollbar_visible:
-      self.add_scroll_bar(scroll_location, scroll_location + height - details_offset - 1, len(lines), 1 + details_offset)
-
-    for line_number in range(scroll_location, len(lines)):
-      y = line_number + details_offset + 1 - scroll_location
-      self._draw_line(scroll_offset, y, lines[line_number], lines[line_number] == selected, width - scroll_offset, current_time)
-
-      if y >= height:
-        break
-
-  def _draw_title(self, entries, showing_details):
-    """
-    Panel title with the number of connections we presently have.
-    """
-
-    if showing_details:
-      self.addstr(0, 0, 'Connection Details:', curses.A_STANDOUT)
-    elif not entries:
-      self.addstr(0, 0, 'Connections:', curses.A_STANDOUT)
-    else:
-      counts = collections.Counter([entry.get_type() for entry in entries])
-      count_labels = ['%i %s' % (counts[category], category.lower()) for category in Category if counts[category]]
-      self.addstr(0, 0, 'Connections (%s):' % ', '.join(count_labels), curses.A_STANDOUT)
-
-  def _draw_details(self, selected, width, is_scrollbar_visible):
-    """
-    Shows detailed information about the selected connection.
-    """
-
-    attr = (CONFIG['attr.connection.category_color'].get(selected.entry.get_type(), 'white'), curses.A_BOLD)
-
-    if selected.line_type == LineType.CIRCUIT_HEADER and selected.circuit.status != 'BUILT':
-      self.addstr(1, 2, 'Building Circuit...', *attr)
-    else:
-      address = '<scrubbed>' if selected.entry.is_private() else selected.connection.remote_address
-      self.addstr(1, 2, 'address: %s:%s' % (address, selected.connection.remote_port), *attr)
-      self.addstr(2, 2, 'locale: %s' % ('??' if selected.entry.is_private() else (selected.locale if selected.locale else '??')), *attr)
-
-      matches = nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(selected.connection.remote_address)
-
-      if not matches:
-        self.addstr(3, 2, 'No consensus data found', *attr)
-      elif len(matches) == 1 or selected.connection.remote_port in matches:
-        controller = tor_controller()
-        fingerprint = matches.values()[0] if len(matches) == 1 else matches[selected.connection.remote_port]
-        router_status_entry = controller.get_network_status(fingerprint, None)
-
-        self.addstr(2, 15, 'fingerprint: %s' % fingerprint, *attr)
-
-        if router_status_entry:
-          dir_port_label = 'dirport: %s' % router_status_entry.dir_port if router_status_entry.dir_port else ''
-          self.addstr(3, 2, 'nickname: %-25s orport: %-10s %s' % (router_status_entry.nickname, router_status_entry.or_port, dir_port_label), *attr)
-          self.addstr(4, 2, 'published: %s' % router_status_entry.published.strftime("%H:%M %m/%d/%Y"), *attr)
-          self.addstr(5, 2, 'flags: %s' % ', '.join(router_status_entry.flags), *attr)
-
-          server_descriptor = controller.get_server_descriptor(fingerprint, None)
-
-          if server_descriptor:
-            policy_label = server_descriptor.exit_policy.summary() if server_descriptor.exit_policy else 'unknown'
-            self.addstr(6, 2, 'exit policy: %s' % policy_label, *attr)
-            self.addstr(4, 38, 'os: %-14s version: %s' % (server_descriptor.operating_system, server_descriptor.tor_version), *attr)
-
-            if server_descriptor.contact:
-              self.addstr(7, 2, 'contact: %s' % server_descriptor.contact, *attr)
-      else:
-        self.addstr(3, 2, 'Multiple matches, possible fingerprints are:', *attr)
-
-        for i, port in enumerate(sorted(matches.keys())):
-          is_last_line, remaining_relays = i == 3, len(matches) - i
-
-          if not is_last_line or remaining_relays == 1:
-            self.addstr(4 + i, 2, '%i. or port: %-5s fingerprint: %s' % (i + 1, port, matches[port]), *attr)
-          else:
-            self.addstr(4 + i, 2, '... %i more' % remaining_relays, *attr)
-
-          if is_last_line:
-            break
-
-    # draw the border, with a 'T' pipe if connecting with the scrollbar
-
-    ui_tools.draw_box(self, 0, 0, width, DETAILS_HEIGHT + 2)
-
-    if is_scrollbar_visible:
-      self.addch(DETAILS_HEIGHT + 1, 1, curses.ACS_TTEE)
-
-  def _draw_line(self, x, y, line, is_selected, width, current_time):
-    attr = nyx.util.ui_tools.get_color(CONFIG['attr.connection.category_color'].get(line.entry.get_type(), 'white'))
-    attr |= curses.A_STANDOUT if is_selected else curses.A_NORMAL
-
-    self.addstr(y, x, ' ' * (width - x), attr)
-
-    if line.line_type == LineType.CIRCUIT:
-      if line.circuit.path[-1][0] == line.fingerprint:
-        prefix = (ord(' '), curses.ACS_LLCORNER, curses.ACS_HLINE, ord(' '))
-      else:
-        prefix = (ord(' '), curses.ACS_VLINE, ord(' '), ord(' '))
-
-      for char in prefix:
-        x = self.addch(y, x, char)
-    else:
-      x += 1  # offset from edge
-
-    self._draw_address_column(x, y, line, attr)
-    self._draw_line_details(57, y, line, width - 57 - 20, attr)
-    self._draw_right_column(width - 18, y, line, current_time, attr)
-
-  def _draw_address_column(self, x, y, line, attr):
-    src = tor_controller().get_info('address', line.connection.local_address)
-    src += ':%s' % line.connection.local_port if line.line_type == LineType.CONNECTION else ''
-
-    if line.line_type == LineType.CIRCUIT_HEADER and line.circuit.status != 'BUILT':
-      dst = 'Building...'
-    else:
-      dst = '<scrubbed>' if line.entry.is_private() else line.connection.remote_address
-      dst += ':%s' % line.connection.remote_port
-
-      if line.entry.get_type() == Category.EXIT:
-        purpose = connection.port_usage(line.connection.remote_port)
-
-        if purpose:
-          dst += ' (%s)' % str_tools.crop(purpose, 26 - len(dst) - 3)
-      elif not tor_controller().is_geoip_unavailable() and not line.entry.is_private():
-        dst += ' (%s)' % (line.locale if line.locale else '??')
-
-    if line.entry.get_type() in (Category.INBOUND, Category.SOCKS, Category.CONTROL):
-      dst, src = src, dst
-
-    if line.line_type == LineType.CIRCUIT:
-      self.addstr(y, x, dst, attr)
-    else:
-      self.addstr(y, x, '%-21s  -->  %-26s' % (src, dst), attr)
-
-  def _draw_line_details(self, x, y, line, width, attr):
-    if line.line_type == LineType.CIRCUIT_HEADER:
-      comp = ['Purpose: %s' % line.circuit.purpose.capitalize(), ', Circuit ID: %s' % line.circuit.id]
-    elif line.entry.get_type() in (Category.SOCKS, Category.HIDDEN, Category.CONTROL):
-      try:
-        port = line.connection.local_port if line.entry.get_type() == Category.HIDDEN else line.connection.remote_port
-        process = nyx.util.tracker.get_port_usage_tracker().fetch(port)
-        comp = ['%s (%s)' % (process.name, process.pid) if process.pid else process.name]
-      except nyx.util.tracker.UnresolvedResult:
-        comp = ['resolving...']
-      except nyx.util.tracker.UnknownApplication:
-        comp = ['UNKNOWN']
-    else:
-      comp = ['%-40s' % (line.fingerprint if line.fingerprint else 'UNKNOWN'), '  ' + (line.nickname if line.nickname else 'UNKNOWN')]
-
-    for entry in comp:
-      if width >= x + len(entry):
-        x = self.addstr(y, x, entry, attr)
-      else:
-        return
-
-  def _draw_right_column(self, x, y, line, current_time, attr):
-    if line.line_type == LineType.CIRCUIT:
-      circ_path = [fp for fp, _ in line.circuit.path]
-      circ_index = circ_path.index(line.fingerprint)
-
-      if circ_index == len(circ_path) - 1:
-        placement_type = 'Exit' if line.circuit.status == 'BUILT' else 'Extending'
-      elif circ_index == 0:
-        placement_type = 'Guard'
-      else:
-        placement_type = 'Middle'
-
-      self.addstr(y, x + 4, '%i / %s' % (circ_index + 1, placement_type), attr)
-    else:
-      x = self.addstr(y, x, '+' if line.connection.is_legacy else ' ', attr)
-      x = self.addstr(y, x, '%5s' % str_tools.time_label(current_time - line.connection.start_time, 1), attr)
-      x = self.addstr(y, x, ' (', attr)
-      x = self.addstr(y, x, line.entry.get_type().upper(), attr | curses.A_BOLD)
-      x = self.addstr(y, x, ')', attr)
-
-  def stop(self):
-    """
-    Halts further resolutions and terminates the thread.
-    """
-
-    with self._pause_condition:
-      self._halt = True
-      self._pause_condition.notifyAll()
-
-  def _update(self):
-    """
-    Fetches the newest resolved connections.
-    """
-
-    global LAST_RETRIEVED_CIRCUITS, LAST_RETRIEVED_HS_CONF
-
-    controller = tor_controller()
-    LAST_RETRIEVED_CIRCUITS = controller.get_circuits([])
-    LAST_RETRIEVED_HS_CONF = controller.get_hidden_service_conf({})
-
-    conn_resolver = nyx.util.tracker.get_connection_tracker()
-    current_resolution_count = conn_resolver.run_counter()
-
-    if not conn_resolver.is_alive():
-      return  # if we're not fetching connections then this is a no-op
-    elif current_resolution_count == self._last_resource_fetch:
-      return  # no new connections to process
-
-    new_entries = [Entry.from_connection(conn) for conn in conn_resolver.get_value()]
-
-    for circ in LAST_RETRIEVED_CIRCUITS:
-      # Skips established single-hop circuits (these are for directory
-      # fetches, not client circuits)
-
-      if not (circ.status == 'BUILT' and len(circ.path) == 1):
-        new_entries.append(Entry.from_circuit(circ))
-
-    # update stats for client and exit connections
-
-    for entry in new_entries:
-      line = entry.get_lines()[0]
-
-      if entry.is_private() and line.connection not in self._counted_connections:
-        if entry.get_type() == Category.INBOUND and line.locale:
-          self._client_locale_usage[line.locale] = self._client_locale_usage.get(line.locale, 0) + 1
-        elif entry.get_type() == Category.EXIT:
-          self._exit_port_usage[line.connection.remote_port] = self._exit_port_usage.get(line.connection.remote_port, 0) + 1
-
-        self._counted_connections.add(line.connection)
-
-    self._entries = sorted(new_entries, key = lambda entry: [entry.sort_value(attr) for attr in self._sort_order])
-    self._last_resource_fetch = current_resolution_count
-
-    if CONFIG['features.connection.resolveApps']:
-      local_ports, remote_ports = [], []
-
-      for entry in new_entries:
-        line = entry.get_lines()[0]
-
-        if entry.get_type() in (Category.SOCKS, Category.CONTROL):
-          local_ports.append(line.connection.remote_port)
-        elif entry.get_type() == Category.HIDDEN:
-          remote_ports.append(line.connection.local_port)
-
-      nyx.util.tracker.get_port_usage_tracker().query(local_ports, remote_ports)
diff --git a/nyx/controller.py b/nyx/controller.py
index e143b49..318df4b 100644
--- a/nyx/controller.py
+++ b/nyx/controller.py
@@ -9,14 +9,15 @@ import threading
import nyx.menu.menu
 import nyx.popups
-import nyx.header_panel
-import nyx.log_panel
-import nyx.config_panel
-import nyx.torrc_panel
-import nyx.graph_panel
-import nyx.connection_panel
 import nyx.util.tracker
+import nyx.panel.config
+import nyx.panel.connection
+import nyx.panel.graph
+import nyx.panel.header
+import nyx.panel.log
+import nyx.panel.torrc
+
 import stem
from stem.util import conf, log
@@ -102,29 +103,29 @@ class Controller:
     self._screen = stdscr
self._sticky_panels = [
-      nyx.header_panel.HeaderPanel(stdscr),
+      nyx.panel.header.HeaderPanel(stdscr),
       LabelPanel(stdscr),
     ]
self._page_panels, first_page_panels = [], []
if CONFIG['features.panels.show.graph']:
-      first_page_panels.append(nyx.graph_panel.GraphPanel(stdscr))
+      first_page_panels.append(nyx.panel.graph.GraphPanel(stdscr))
if CONFIG['features.panels.show.log']:
-      first_page_panels.append(nyx.log_panel.LogPanel(stdscr))
+      first_page_panels.append(nyx.panel.log.LogPanel(stdscr))
if first_page_panels:
       self._page_panels.append(first_page_panels)
if CONFIG['features.panels.show.connection']:
-      self._page_panels.append([nyx.connection_panel.ConnectionPanel(stdscr)])
+      self._page_panels.append([nyx.panel.connection.ConnectionPanel(stdscr)])
if CONFIG['features.panels.show.config']:
-      self._page_panels.append([nyx.config_panel.ConfigPanel(stdscr)])
+      self._page_panels.append([nyx.panel.config.ConfigPanel(stdscr)])
if CONFIG['features.panels.show.torrc']:
-      self._page_panels.append([nyx.torrc_panel.TorrcPanel(stdscr)])
+      self._page_panels.append([nyx.panel.torrc.TorrcPanel(stdscr)])
self.quit_signal = False
     self._page = 0
diff --git a/nyx/graph_panel.py b/nyx/graph_panel.py
deleted file mode 100644
index 086d04d..0000000
--- a/nyx/graph_panel.py
+++ /dev/null
@@ -1,753 +0,0 @@
-"""
-Graphs of tor related statistics. For example...
-
-Downloaded (0.0 B/sec):           Uploaded (0.0 B/sec):
-  34                                30
-                            *                                 *
-                    **  *   *                          *      **
-      *   *  *      ** **   **          ***  **       ** **   **
-     *********      ******  ******     *********      ******  ******
-   0 ************ ****************   0 ************ ****************
-         25s  50   1m   1.6  2.0           25s  50   1m   1.6  2.0
-"""
-
-import collections
-import copy
-import curses
-import time
-
-import nyx.controller
-import nyx.popups
-import nyx.util.tracker
-
-from stem.control import EventType, Listener
-from stem.util import conf, enum, log, str_tools, system
-from nyx.util import join, msg, panel, tor_controller
-
-GraphStat = enum.Enum(('BANDWIDTH', 'bandwidth'), ('CONNECTIONS', 'connections'), ('SYSTEM_RESOURCES', 'resources'))
-Interval = enum.Enum(('EACH_SECOND', 'each second'), ('FIVE_SECONDS', '5 seconds'), ('THIRTY_SECONDS', '30 seconds'), ('MINUTELY', 'minutely'), ('FIFTEEN_MINUTE', '15 minute'), ('THIRTY_MINUTE', '30 minute'), ('HOURLY', 'hourly'), ('DAILY', 'daily'))
-Bounds = enum.Enum(('GLOBAL_MAX', 'global_max'), ('LOCAL_MAX', 'local_max'), ('TIGHT', 'tight'))
-
-DrawAttributes = collections.namedtuple('DrawAttributes', ('stat', 'subgraph_height', 'subgraph_width', 'interval', 'bounds_type', 'accounting'))
-
-INTERVAL_SECONDS = {
-  Interval.EACH_SECOND: 1,
-  Interval.FIVE_SECONDS: 5,
-  Interval.THIRTY_SECONDS: 30,
-  Interval.MINUTELY: 60,
-  Interval.FIFTEEN_MINUTE: 900,
-  Interval.THIRTY_MINUTE: 1800,
-  Interval.HOURLY: 3600,
-  Interval.DAILY: 86400,
-}
-
-PRIMARY_COLOR, SECONDARY_COLOR = 'green', 'cyan'
-
-ACCOUNTING_RATE = 5
-DEFAULT_CONTENT_HEIGHT = 4  # space needed for labeling above and below the graph
-WIDE_LABELING_GRAPH_COL = 50  # minimum graph columns to use wide spacing for x-axis labels
-COLLAPSE_WIDTH = 135  # width at which to move optional stats from the title to x-axis label
-
-
-def conf_handler(key, value):
-  if key == 'features.graph.height':
-    return max(1, value)
-  elif key == 'features.graph.max_width':
-    return max(1, value)
-  elif key == 'features.graph.type':
-    if value != 'none' and value not in GraphStat:
-      log.warn("'%s' isn't a valid graph type, options are: none, %s" % (CONFIG['features.graph.type'], ', '.join(GraphStat)))
-      return CONFIG['features.graph.type']  # keep the default
-  elif key == 'features.graph.interval':
-    if value not in Interval:
-      log.warn("'%s' isn't a valid graphing interval, options are: %s" % (value, ', '.join(Interval)))
-      return CONFIG['features.graph.interval']  # keep the default
-  elif key == 'features.graph.bound':
-    if value not in Bounds:
-      log.warn("'%s' isn't a valid graph bounds, options are: %s" % (value, ', '.join(Bounds)))
-      return CONFIG['features.graph.bound']  # keep the default
-
-
-CONFIG = conf.config_dict('nyx', {
-  'attr.hibernate_color': {},
-  'attr.graph.title': {},
-  'attr.graph.header.primary': {},
-  'attr.graph.header.secondary': {},
-  'features.graph.height': 7,
-  'features.graph.type': GraphStat.BANDWIDTH,
-  'features.graph.interval': Interval.EACH_SECOND,
-  'features.graph.bound': Bounds.LOCAL_MAX,
-  'features.graph.max_width': 300,  # we need some sort of max size so we know how much graph data to retain
-  'features.panels.show.connection': True,
-  'features.graph.bw.transferInBytes': False,
-  'features.graph.bw.accounting.show': True,
-}, conf_handler)
-
-
-class GraphData(object):
-  """
-  Graphable statistical information.
-
-  :var int latest_value: last value we recorded
-  :var int total: sum of all values we've recorded
-  :var int tick: number of events we've processed
-  :var dict values: mapping of intervals to an array of samplings from newest to oldest
-  :var dict max_value: mapping of intervals to the maximum value it has had
-  """
-
-  def __init__(self, clone = None, category = None, is_primary = True):
-    if clone:
-      self.latest_value = clone.latest_value
-      self.total = clone.total
-      self.tick = clone.tick
-      self.values = copy.deepcopy(clone.values)
-      self.max_value = dict(clone.max_value)
-
-      self._category = clone._category
-      self._is_primary = clone._is_primary
-      self._in_process_value = dict(clone._in_process_value)
-    else:
-      self.latest_value = 0
-      self.total = 0
-      self.tick = 0
-      self.values = dict([(i, CONFIG['features.graph.max_width'] * [0]) for i in Interval])
-      self.max_value = dict([(i, 0) for i in Interval])
-
-      self._category = category
-      self._is_primary = is_primary
-      self._in_process_value = dict([(i, 0) for i in Interval])
-
-  def average(self):
-    return self.total / max(1, self.tick)
-
-  def update(self, new_value):
-    self.latest_value = new_value
-    self.total += new_value
-    self.tick += 1
-
-    for interval in Interval:
-      interval_seconds = INTERVAL_SECONDS[interval]
-      self._in_process_value[interval] += new_value
-
-      if self.tick % interval_seconds == 0:
-        new_entry = self._in_process_value[interval] / interval_seconds
-        self.values[interval] = [new_entry] + self.values[interval][:-1]
-        self.max_value[interval] = max(self.max_value[interval], new_entry)
-        self._in_process_value[interval] = 0
-
-  def header(self, width):
-    """
-    Provides the description above a subgraph.
-
-    :param int width: maximum length of the header
-
-    :returns: **str** with our graph header
-    """
-
-    return self._category._header(width, self._is_primary)
-
-  def y_axis_label(self, value):
-    """
-    Provides the label we should display on our y-axis.
-
-    :param int value: value being shown on the y-axis
-
-    :returns: **str** with our y-axis label
-    """
-
-    return self._category._y_axis_label(value, self._is_primary)
-
-
-class GraphCategory(object):
-  """
-  Category for the graph. This maintains two subgraphs, updating them each
-  second with updated stats.
-
-  :var GraphData primary: first subgraph
-  :var GraphData secondary: second subgraph
-  :var float start_time: unix timestamp for when we started
-  """
-
-  def __init__(self, clone = None):
-    if clone:
-      self.primary = GraphData(clone.primary)
-      self.secondary = GraphData(clone.secondary)
-      self.start_time = clone.start_time
-      self._title_stats = list(clone._title_stats)
-      self._primary_header_stats = list(clone._primary_header_stats)
-      self._secondary_header_stats = list(clone._secondary_header_stats)
-    else:
-      self.primary = GraphData(category = self, is_primary = True)
-      self.secondary = GraphData(category = self, is_primary = False)
-      self.start_time = time.time()
-      self._title_stats = []
-      self._primary_header_stats = []
-      self._secondary_header_stats = []
-
-  def stat_type(self):
-    """
-    Provides the GraphStat this graph is for.
-
-    :returns: **GraphStat** of this graph
-    """
-
-    raise NotImplementedError('Should be implemented by subclasses')
-
-  def title(self, width):
-    """
-    Provides a graph title that fits in the given width.
-
-    :param int width: maximum length of the title
-
-    :returns: **str** with our title
-    """
-
-    title = CONFIG['attr.graph.title'].get(self.stat_type(), '')
-    title_stats = join(self._title_stats, ', ', width - len(title) - 4)
-    return '%s (%s):' % (title, title_stats) if title_stats else title + ':'
-
-  def bandwidth_event(self, event):
-    """
-    Called when it's time to process another event. All graphs use tor BW
-    events to keep in sync with each other (this happens once per second).
-    """
-
-    pass
-
-  def _header(self, is_primary, width):
-    if is_primary:
-      header = CONFIG['attr.graph.header.primary'].get(self.stat_type(), '')
-      header_stats = self._primary_header_stats
-    else:
-      header = CONFIG['attr.graph.header.secondary'].get(self.stat_type(), '')
-      header_stats = self._secondary_header_stats
-
-    header_stats = join(header_stats, '', width - len(header) - 4)
-    return '%s (%s):' % (header, header_stats) if header_stats else '%s:' % header
-
-  def _y_axis_label(self, value, is_primary):
-    return str(value)
-
-
-class BandwidthStats(GraphCategory):
-  """
-  Tracks tor's bandwidth usage.
-  """
-
-  def __init__(self, clone = None):
-    GraphCategory.__init__(self, clone)
-
-    if not clone:
-      # fill in past bandwidth information
-
-      controller = tor_controller()
-      bw_entries, is_successful = controller.get_info('bw-event-cache', None), True
-
-      if bw_entries:
-        for entry in bw_entries.split():
-          entry_comp = entry.split(',')
-
-          if len(entry_comp) != 2 or not entry_comp[0].isdigit() or not entry_comp[1].isdigit():
-            log.warn(msg('panel.graphing.bw_event_cache_malformed', response = bw_entries))
-            is_successful = False
-            break
-
-          self.primary.update(int(entry_comp[0]))
-          self.secondary.update(int(entry_comp[1]))
-
-        if is_successful:
-          log.info(msg('panel.graphing.prepopulation_successful', duration = str_tools.time_label(len(bw_entries.split()), is_long = True)))
-
-      read_total = controller.get_info('traffic/read', None)
-      write_total = controller.get_info('traffic/written', None)
-      start_time = system.start_time(controller.get_pid(None))
-
-      if read_total and write_total and start_time:
-        self.primary.total = int(read_total)
-        self.secondary.total = int(write_total)
-        self.start_time = start_time
-
-  def stat_type(self):
-    return GraphStat.BANDWIDTH
-
-  def _y_axis_label(self, value, is_primary):
-    return _size_label(value, 0)
-
-  def bandwidth_event(self, event):
-    self.primary.update(event.read)
-    self.secondary.update(event.written)
-
-    self._primary_header_stats = [
-      '%-14s' % ('%s/sec' % _size_label(self.primary.latest_value)),
-      '- avg: %s/sec' % _size_label(self.primary.total / (time.time() - self.start_time)),
-      ', total: %s' % _size_label(self.primary.total),
-    ]
-
-    self._secondary_header_stats = [
-      '%-14s' % ('%s/sec' % _size_label(self.secondary.latest_value)),
-      '- avg: %s/sec' % _size_label(self.secondary.total / (time.time() - self.start_time)),
-      ', total: %s' % _size_label(self.secondary.total),
-    ]
-
-    controller = tor_controller()
-
-    stats = []
-    bw_rate = controller.get_effective_rate(None)
-    bw_burst = controller.get_effective_rate(None, burst = True)
-
-    if bw_rate and bw_burst:
-      bw_rate_label = _size_label(bw_rate)
-      bw_burst_label = _size_label(bw_burst)
-
-      # if both are using rounded values then strip off the '.0' decimal
-
-      if '.0' in bw_rate_label and '.0' in bw_burst_label:
-        bw_rate_label = bw_rate_label.split('.', 1)[0]
-        bw_burst_label = bw_burst_label.split('.', 1)[0]
-
-      stats.append('limit: %s/s' % bw_rate_label)
-      stats.append('burst: %s/s' % bw_burst_label)
-
-    my_router_status_entry = controller.get_network_status(default = None)
-    measured_bw = getattr(my_router_status_entry, 'bandwidth', None)
-
-    if measured_bw:
-      stats.append('measured: %s/s' % _size_label(measured_bw))
-    else:
-      my_server_descriptor = controller.get_server_descriptor(default = None)
-      observed_bw = getattr(my_server_descriptor, 'observed_bandwidth', None)
-
-      if observed_bw:
-        stats.append('observed: %s/s' % _size_label(observed_bw))
-
-    self._title_stats = stats
-
-
-class ConnectionStats(GraphCategory):
-  """
-  Tracks number of inbound and outbound connections.
-  """
-
-  def stat_type(self):
-    return GraphStat.CONNECTIONS
-
-  def bandwidth_event(self, event):
-    inbound_count, outbound_count = 0, 0
-
-    controller = tor_controller()
-    or_ports = controller.get_ports(Listener.OR, [])
-    dir_ports = controller.get_ports(Listener.DIR, [])
-    control_ports = controller.get_ports(Listener.CONTROL, [])
-
-    for entry in nyx.util.tracker.get_connection_tracker().get_value():
-      if entry.local_port in or_ports or entry.local_port in dir_ports:
-        inbound_count += 1
-      elif entry.local_port in control_ports:
-        pass  # control connection
-      else:
-        outbound_count += 1
-
-    self.primary.update(inbound_count)
-    self.secondary.update(outbound_count)
-
-    self._primary_header_stats = [str(self.primary.latest_value), ', avg: %s' % self.primary.average()]
-    self._secondary_header_stats = [str(self.secondary.latest_value), ', avg: %s' % self.secondary.average()]
-
-
-class ResourceStats(GraphCategory):
-  """
-  Tracks cpu and memory usage of the tor process.
-  """
-
-  def stat_type(self):
-    return GraphStat.SYSTEM_RESOURCES
-
-  def _y_axis_label(self, value, is_primary):
-    return '%i%%' % value if is_primary else str_tools.size_label(value)
-
-  def bandwidth_event(self, event):
-    resources = nyx.util.tracker.get_resource_tracker().get_value()
-    self.primary.update(resources.cpu_sample * 100)  # decimal percentage to whole numbers
-    self.secondary.update(resources.memory_bytes)
-
-    self._primary_header_stats = ['%0.1f%%' % self.primary.latest_value, ', avg: %0.1f%%' % self.primary.average()]
-    self._secondary_header_stats = [str_tools.size_label(self.secondary.latest_value, 1), ', avg: %s' % str_tools.size_label(self.secondary.average(), 1)]
-
-
-class GraphPanel(panel.Panel):
-  """
-  Panel displaying graphical information of GraphCategory instances.
-  """
-
-  def __init__(self, stdscr):
-    panel.Panel.__init__(self, stdscr, 'graph', 0)
-
-    self._displayed_stat = None if CONFIG['features.graph.type'] == 'none' else CONFIG['features.graph.type']
-    self._update_interval = CONFIG['features.graph.interval']
-    self._bounds = CONFIG['features.graph.bound']
-    self._graph_height = CONFIG['features.graph.height']
-
-    self._accounting_stats = None
-
-    self._stats = {
-      GraphStat.BANDWIDTH: BandwidthStats(),
-      GraphStat.SYSTEM_RESOURCES: ResourceStats(),
-    }
-
-    if CONFIG['features.panels.show.connection']:
-      self._stats[GraphStat.CONNECTIONS] = ConnectionStats()
-    elif self._displayed_stat == GraphStat.CONNECTIONS:
-      log.warn("The connection graph is unavailble when you set 'features.panels.show.connection false'.")
-      self._displayed_stat = GraphStat.BANDWIDTH
-
-    self.set_pause_attr('_stats')
-    self.set_pause_attr('_accounting_stats')
-
-    controller = tor_controller()
-    controller.add_event_listener(self._update_accounting, EventType.BW)
-    controller.add_event_listener(self._update_stats, EventType.BW)
-    controller.add_status_listener(lambda *args: self.redraw(True))
-
-  @property
-  def displayed_stat(self):
-    return self._displayed_stat
-
-  @displayed_stat.setter
-  def displayed_stat(self, value):
-    if value is not None and value not in self._stats.keys():
-      raise ValueError("%s isn't a graphed statistic" % value)
-
-    self._displayed_stat = value
-
-  def stat_options(self):
-    return self._stats.keys()
-
-  @property
-  def update_interval(self):
-    return self._update_interval
-
-  @update_interval.setter
-  def update_interval(self, value):
-    if value not in Interval:
-      raise ValueError("%s isn't a valid graphing update interval" % value)
-
-    self._update_interval = value
-
-  @property
-  def bounds_type(self):
-    return self._bounds
-
-  @bounds_type.setter
-  def bounds_type(self, value):
-    if value not in Bounds:
-      raise ValueError("%s isn't a valid type of bounds" % value)
-
-    self._bounds = value
-
-  def get_height(self):
-    """
-    Provides the height of the content.
-    """
-
-    if not self.displayed_stat:
-      return 0
-
-    height = DEFAULT_CONTENT_HEIGHT + self._graph_height
-
-    if self.displayed_stat == GraphStat.BANDWIDTH and self._accounting_stats:
-      height += 3
-
-    return height
-
-  def set_graph_height(self, new_graph_height):
-    self._graph_height = max(1, new_graph_height)
-
-  def resize_graph(self):
-    """
-    Prompts for user input to resize the graph panel. Options include...
-
-      * down arrow - grow graph
-      * up arrow - shrink graph
-      * enter / space - set size
-    """
-
-    control = nyx.controller.get_controller()
-
-    with panel.CURSES_LOCK:
-      try:
-        while True:
-          msg = 'press the down/up to resize the graph, and enter when done'
-          control.set_msg(msg, curses.A_BOLD, True)
-          curses.cbreak()
-          key = control.key_input()
-
-          if key.match('down'):
-            # don't grow the graph if it's already consuming the whole display
-            # (plus an extra line for the graph/log gap)
-
-            max_height = self.parent.getmaxyx()[0] - self.top
-            current_height = self.get_height()
-
-            if current_height < max_height + 1:
-              self.set_graph_height(self._graph_height + 1)
-          elif key.match('up'):
-            self.set_graph_height(self._graph_height - 1)
-          elif key.is_selection():
-            break
-
-          control.redraw()
-      finally:
-        control.set_msg()
-
-  def handle_key(self, key):
-    if key.match('r'):
-      self.resize_graph()
-    elif key.match('b'):
-      # uses the next boundary type
-      self.bounds_type = Bounds.next(self.bounds_type)
-      self.redraw(True)
-    elif key.match('s'):
-      # provides a menu to pick the graphed stats
-
-      available_stats = sorted(self.stat_options())
-      options = ['None'] + [stat.capitalize() for stat in available_stats]
-      initial_selection = available_stats.index(self.displayed_stat) + 1 if self.displayed_stat else 0
-
-      selection = nyx.popups.show_menu('Graphed Stats:', options, initial_selection)
-
-      # applies new setting
-
-      if selection == 0:
-        self.displayed_stat = None
-      elif selection != -1:
-        self.displayed_stat = available_stats[selection - 1]
-    elif key.match('i'):
-      # provides menu to pick graph panel update interval
-
-      selection = nyx.popups.show_menu('Update Interval:', list(Interval), list(Interval).index(self.update_interval))
-
-      if selection != -1:
-        self.update_interval = list(Interval)[selection]
-    else:
-      return False
-
-    return True
-
-  def get_help(self):
-    return [
-      ('r', 'resize graph', None),
-      ('s', 'graphed stats', self.displayed_stat if self.displayed_stat else 'none'),
-      ('b', 'graph bounds', self.bounds_type.replace('_', ' ')),
-      ('i', 'graph update interval', self.update_interval),
-    ]
-
-  def draw(self, width, height):
-    if not self.displayed_stat:
-      return
-
-    stat = self.get_attr('_stats')[self.displayed_stat]
-
-    attr = DrawAttributes(
-      stat = type(stat)(stat),  # clone the GraphCategory
-      subgraph_height = self._graph_height + 2,  # graph rows + header + x-axis label
-      subgraph_width = min(width / 2, CONFIG['features.graph.max_width']),
-      interval = self.update_interval,
-      bounds_type = self.bounds_type,
-      accounting = self.get_attr('_accounting_stats'),
-    )
-
-    if self.is_title_visible():
-      self.addstr(0, 0, attr.stat.title(width), curses.A_STANDOUT)
-
-    self._draw_subgraph(attr, attr.stat.primary, 0, PRIMARY_COLOR)
-    self._draw_subgraph(attr, attr.stat.secondary, attr.subgraph_width, SECONDARY_COLOR)
-
-    if attr.stat.stat_type() == GraphStat.BANDWIDTH:
-      if width <= COLLAPSE_WIDTH:
-        self._draw_bandwidth_stats(attr, width)
-
-      if attr.accounting:
-        self._draw_accounting_stats(attr)
-
-  def _draw_subgraph(self, attr, data, x, color):
-    # Concering our subgraph colums, the y-axis label can be at most six
-    # characters, with two spaces of padding on either side of the graph.
-    # Starting with the smallest size, then possibly raise it after determing
-    # the y_axis_labels.
-
-    subgraph_columns = attr.subgraph_width - 8
-    min_bound, max_bound = self._get_graph_bounds(attr, data, subgraph_columns)
-
-    x_axis_labels = self._get_x_axis_labels(attr, subgraph_columns)
-    y_axis_labels = self._get_y_axis_labels(attr, data, min_bound, max_bound)
-    subgraph_columns = max(subgraph_columns, attr.subgraph_width - max([len(label) for label in y_axis_labels.values()]) - 2)
-    axis_offset = max([len(label) for label in y_axis_labels.values()])
-
-    self.addstr(1, x, data.header(attr.subgraph_width), curses.A_BOLD, color)
-
-    for x_offset, label in x_axis_labels.items():
-      self.addstr(attr.subgraph_height, x + x_offset + axis_offset, label, color)
-
-    for y, label in y_axis_labels.items():
-      self.addstr(y, x, label, color)
-
-    for col in range(subgraph_columns):
-      column_count = int(data.values[attr.interval][col]) - min_bound
-      column_height = int(min(attr.subgraph_height - 2, (attr.subgraph_height - 2) * column_count / (max(1, max_bound) - min_bound)))
-
-      for row in range(column_height):
-        self.addstr(attr.subgraph_height - 1 - row, x + col + axis_offset + 1, ' ', curses.A_STANDOUT, color)
-
-  def _get_graph_bounds(self, attr, data, subgraph_columns):
-    """
-    Provides the range the graph shows (ie, its minimum and maximum value).
-    """
-
-    min_bound, max_bound = 0, 0
-    values = data.values[attr.interval][:subgraph_columns]
-
-    if attr.bounds_type == Bounds.GLOBAL_MAX:
-      max_bound = data.max_value[attr.interval]
-    elif subgraph_columns > 0:
-      max_bound = max(values)  # local maxima
-
-    if attr.bounds_type == Bounds.TIGHT and subgraph_columns > 0:
-      min_bound = min(values)
-
-      # if the max = min pick zero so we still display something
-
-      if min_bound == max_bound:
-        min_bound = 0
-
-    return min_bound, max_bound
-
-  def _get_y_axis_labels(self, attr, data, min_bound, max_bound):
-    """
-    Provides the labels for the y-axis. This is a mapping of the position it
-    should be drawn at to its text.
-    """
-
-    y_axis_labels = {
-      2: data.y_axis_label(max_bound),
-      attr.subgraph_height - 1: data.y_axis_label(min_bound),
-    }
-
-    ticks = (attr.subgraph_height - 5) / 2
-
-    for i in range(ticks):
-      row = attr.subgraph_height - (2 * i) - 5
-
-      if attr.subgraph_height % 2 == 0 and i >= (ticks / 2):
-        row -= 1  # make extra gap be in the middle when we're an even size
-
-      val = (max_bound - min_bound) * (attr.subgraph_height - row - 3) / (attr.subgraph_height - 3)
-
-      if val not in (min_bound, max_bound):
-        y_axis_labels[row + 2] = data.y_axis_label(val)
-
-    return y_axis_labels
-
-  def _get_x_axis_labels(self, attr, subgraph_columns):
-    """
-    Provides the labels for the x-axis. We include the units for only its first
-    value, then bump the precision for subsequent units. For example...
-
-      10s, 20, 30, 40, 50, 1m, 1.1, 1.3, 1.5
-    """
-
-    x_axis_labels = {}
-
-    interval_sec = INTERVAL_SECONDS[attr.interval]
-    interval_spacing = 10 if subgraph_columns >= WIDE_LABELING_GRAPH_COL else 5
-    units_label, decimal_precision = None, 0
-
-    for i in range((subgraph_columns - 4) / interval_spacing):
-      x = (i + 1) * interval_spacing
-      time_label = str_tools.time_label(x * interval_sec, decimal_precision)
-
-      if not units_label:
-        units_label = time_label[-1]
-      elif units_label != time_label[-1]:
-        # upped scale so also up precision of future measurements
-        units_label = time_label[-1]
-        decimal_precision += 1
-      else:
-        # if constrained on space then strips labeling since already provided
-        time_label = time_label[:-1]
-
-      x_axis_labels[x] = time_label
-
-    return x_axis_labels
-
-  def _draw_bandwidth_stats(self, attr, width):
-    """
-    Replaces the x-axis labeling with bandwidth stats. This is done on small
-    screens since this information otherwise wouldn't fit.
-    """
-
-    labeling_line = DEFAULT_CONTENT_HEIGHT + attr.subgraph_height - 4
-    self.addstr(labeling_line, 0, ' ' * width)  # clear line
-
-    runtime = time.time() - attr.stat.start_time
-    primary_footer = 'total: %s, avg: %s/sec' % (_size_label(attr.stat.primary.total), _size_label(attr.stat.primary.total / runtime))
-    secondary_footer = 'total: %s, avg: %s/sec' % (_size_label(attr.stat.secondary.total), _size_label(attr.stat.secondary.total / runtime))
-
-    self.addstr(labeling_line, 1, primary_footer, PRIMARY_COLOR)
-    self.addstr(labeling_line, attr.subgraph_width + 1, secondary_footer, SECONDARY_COLOR)
-
-  def _draw_accounting_stats(self, attr):
-    y = DEFAULT_CONTENT_HEIGHT + attr.subgraph_height - 2
-
-    if tor_controller().is_alive():
-      hibernate_color = CONFIG['attr.hibernate_color'].get(attr.accounting.status, 'red')
-
-      x = self.addstr(y, 0, 'Accounting (', curses.A_BOLD)
-      x = self.addstr(y, x, attr.accounting.status, curses.A_BOLD, hibernate_color)
-      x = self.addstr(y, x, ')', curses.A_BOLD)
-
-      self.addstr(y, 35, 'Time to reset: %s' % str_tools.short_time_label(attr.accounting.time_until_reset))
-
-      self.addstr(y + 1, 2, '%s / %s' % (attr.accounting.read_bytes, attr.accounting.read_limit), PRIMARY_COLOR)
-      self.addstr(y + 1, 37, '%s / %s' % (attr.accounting.written_bytes, attr.accounting.write_limit), SECONDARY_COLOR)
-    else:
-      self.addstr(y, 0, 'Accounting:', curses.A_BOLD)
-      self.addstr(y, 12, 'Connection Closed...')
-
-  def copy_attr(self, attr):
-    if attr == '_stats':
-      return dict([(key, type(self._stats[key])(self._stats[key])) for key in self._stats])
-    else:
-      return panel.Panel.copy_attr(self, attr)
-
-  def _update_accounting(self, event):
-    if not CONFIG['features.graph.bw.accounting.show']:
-      self._accounting_stats = None
-    elif not self._accounting_stats or time.time() - self._accounting_stats.retrieved >= ACCOUNTING_RATE:
-      old_accounting_stats = self._accounting_stats
-      self._accounting_stats = tor_controller().get_accounting_stats(None)
-
-      # if we either added or removed accounting info then redraw the whole
-      # screen to account for resizing
-
-      if bool(old_accounting_stats) != bool(self._accounting_stats):
-        nyx.controller.get_controller().redraw()
-
-  def _update_stats(self, event):
-    for stat in self._stats.values():
-      stat.bandwidth_event(event)
-
-    if self.displayed_stat:
-      param = self.get_attr('_stats')[self.displayed_stat]
-      update_rate = INTERVAL_SECONDS[self.update_interval]
-
-      if param.primary.tick % update_rate == 0:
-        self.redraw(True)
-
-
-def _size_label(byte_count, decimal = 1):
-  """
-  Alias for str_tools.size_label() that accounts for if the user prefers bits
-  or bytes.
-  """
-
-  return str_tools.size_label(byte_count, decimal, is_bytes = CONFIG['features.graph.bw.transferInBytes'])
diff --git a/nyx/header_panel.py b/nyx/header_panel.py
deleted file mode 100644
index 0d6591a..0000000
--- a/nyx/header_panel.py
+++ /dev/null
@@ -1,496 +0,0 @@
-"""
-Top panel for every page, containing basic system and tor related information.
-This expands the information it presents to two columns if there's room
-available.
-"""
-
-import collections
-import os
-import time
-import curses
-import threading
-
-import stem
-
-import nyx.controller
-import nyx.popups
-
-from stem.control import Listener, State
-from stem.util import conf, log, proc, str_tools, system
-from nyx.util import msg, tor_controller, panel, tracker
-
-MIN_DUAL_COL_WIDTH = 141  # minimum width where we'll show two columns
-SHOW_FD_THRESHOLD = 60  # show file descriptor usage if usage is over this percentage
-UPDATE_RATE = 5  # rate in seconds at which we refresh
-
-CONFIG = conf.config_dict('nyx', {
-  'attr.flag_colors': {},
-  'attr.version_status_colors': {},
-})
-
-
-class HeaderPanel(panel.Panel, threading.Thread):
-  """
-  Top area containing tor settings and system information.
-  """
-
-  def __init__(self, stdscr):
-    panel.Panel.__init__(self, stdscr, 'header', 0)
-    threading.Thread.__init__(self)
-    self.setDaemon(True)
-
-    self._vals = get_sampling()
-
-    self._pause_condition = threading.Condition()
-    self._halt = False  # terminates thread if true
-    self._reported_inactive = False
-
-    tor_controller().add_status_listener(self.reset_listener)
-
-  def is_wide(self, width = None):
-    """
-    True if we should show two columns of information, False otherwise.
-    """
-
-    if width is None:
-      width = self.get_parent().getmaxyx()[1]
-
-    return width >= MIN_DUAL_COL_WIDTH
-
-  def get_height(self):
-    """
-    Provides the height of the content, which is dynamically determined by the
-    panel's maximum width.
-    """
-
-    if self._vals.is_relay:
-      return 4 if self.is_wide() else 6
-    else:
-      return 3 if self.is_wide() else 4
-
-  def send_newnym(self):
-    """
-    Requests a new identity and provides a visual queue.
-    """
-
-    controller = tor_controller()
-
-    if not controller.is_newnym_available():
-      return
-
-    controller.signal(stem.Signal.NEWNYM)
-
-    # If we're wide then the newnym label in this panel will give an
-    # indication that the signal was sent. Otherwise use a msg.
-
-    if not self.is_wide():
-      nyx.popups.show_msg('Requesting a new identity', 1)
-
-  def handle_key(self, key):
-    if key.match('n'):
-      self.send_newnym()
-    elif key.match('r') and not self._vals.is_connected:
-      # TODO: This is borked. Not quite sure why but our attempt to call
-      # PROTOCOLINFO fails with a socket error, followed by completely freezing
-      # nyx. This is exposing two bugs...
-      #
-      # * This should be working. That's a stem issue.
-      # * Our interface shouldn't be locking up. That's an nyx issue.
-
-      return True
-
-      controller = tor_controller()
-
-      try:
-        controller.connect()
-
-        try:
-          controller.authenticate()  # TODO: should account for our chroot
-        except stem.connection.MissingPassword:
-          password = nyx.popups.input_prompt('Controller Password: ')
-
-          if password:
-            controller.authenticate(password)
-
-        log.notice("Reconnected to Tor's control port")
-        nyx.popups.show_msg('Tor reconnected', 1)
-      except Exception as exc:
-        nyx.popups.show_msg('Unable to reconnect (%s)' % exc, 3)
-        controller.close()
-    else:
-      return False
-
-    return True
-
-  def draw(self, width, height):
-    vals = self._vals  # local reference to avoid concurrency concerns
-    is_wide = self.is_wide(width)
-
-    # space available for content
-
-    left_width = max(width / 2, 77) if is_wide else width
-    right_width = width - left_width
-
-    self._draw_platform_section(0, 0, left_width, vals)
-
-    if vals.is_connected:
-      self._draw_ports_section(0, 1, left_width, vals)
-    else:
-      self._draw_disconnected(0, 1, left_width, vals)
-
-    if is_wide:
-      self._draw_resource_usage(left_width, 0, right_width, vals)
-
-      if vals.is_relay:
-        self._draw_fingerprint_and_fd_usage(left_width, 1, right_width, vals)
-        self._draw_flags(0, 2, left_width, vals)
-        self._draw_exit_policy(left_width, 2, right_width, vals)
-      elif vals.is_connected:
-        self._draw_newnym_option(left_width, 1, right_width, vals)
-    else:
-      self._draw_resource_usage(0, 2, left_width, vals)
-
-      if vals.is_relay:
-        self._draw_fingerprint_and_fd_usage(0, 3, left_width, vals)
-        self._draw_flags(0, 4, left_width, vals)
-
-  def _draw_platform_section(self, x, y, width, vals):
-    """
-    Section providing the user's hostname, platform, and version information...
-
-      nyx - odin (Linux 3.5.0-52-generic)        Tor 0.2.5.1-alpha-dev (unrecommended)
-      |------ platform (40 characters) ------|   |----------- tor version -----------|
-    """
-
-    initial_x, space_left = x, min(width, 40)
-
-    x = self.addstr(y, x, vals.format('nyx - {hostname}', space_left))
-    space_left -= x - initial_x
-
-    if space_left >= 10:
-      self.addstr(y, x, ' (%s)' % vals.format('{platform}', space_left - 3))
-
-    x, space_left = initial_x + 43, width - 43
-
-    if vals.version != 'Unknown' and space_left >= 10:
-      x = self.addstr(y, x, vals.format('Tor {version}', space_left))
-      space_left -= x - 43 - initial_x
-
-      if space_left >= 7 + len(vals.version_status):
-        version_color = CONFIG['attr.version_status_colors'].get(vals.version_status, 'white')
-
-        x = self.addstr(y, x, ' (')
-        x = self.addstr(y, x, vals.version_status, version_color)
-        self.addstr(y, x, ')')
-
-  def _draw_ports_section(self, x, y, width, vals):
-    """
-    Section providing our nickname, address, and port information...
-
-      Unnamed - 0.0.0.0:7000, Control Port (cookie): 9051
-    """
-
-    if not vals.is_relay:
-      x = self.addstr(y, x, 'Relaying Disabled', 'cyan')
-    else:
-      x = self.addstr(y, x, vals.format('{nickname} - {address}:{or_port}'))
-
-      if vals.dir_port != '0':
-        x = self.addstr(y, x, vals.format(', Dir Port: {dir_port}'))
-
-    if vals.control_port:
-      if width >= x + 19 + len(vals.control_port) + len(vals.auth_type):
-        auth_color = 'red' if vals.auth_type == 'open' else 'green'
-
-        x = self.addstr(y, x, ', Control Port (')
-        x = self.addstr(y, x, vals.auth_type, auth_color)
-        self.addstr(y, x, vals.format('): {control_port}'))
-      else:
-        self.addstr(y, x, vals.format(', Control Port: {control_port}'))
-    elif vals.socket_path:
-      self.addstr(y, x, vals.format(', Control Socket: {socket_path}'))
-
-  def _draw_disconnected(self, x, y, width, vals):
-    """
-    Message indicating that tor is disconnected...
-
-      Tor Disconnected (15:21 07/13/2014, press r to reconnect)
-    """
-
-    x = self.addstr(y, x, 'Tor Disconnected', curses.A_BOLD, 'red')
-    last_heartbeat = time.strftime('%H:%M %m/%d/%Y', time.localtime(vals.last_heartbeat))
-    self.addstr(y, x, ' (%s, press r to reconnect)' % last_heartbeat)
-
-  def _draw_resource_usage(self, x, y, width, vals):
-    """
-    System resource usage of the tor process...
-
-      cpu: 0.0% tor, 1.0% nyx    mem: 0 (0.0%)       pid: 16329  uptime: 12-20:42:07
-    """
-
-    if vals.start_time:
-      if not vals.is_connected:
-        now = vals.connection_time
-      elif self.is_paused():
-        now = self.get_pause_time()
-      else:
-        now = time.time()
-
-      uptime = str_tools.short_time_label(now - vals.start_time)
-    else:
-      uptime = ''
-
-    sys_fields = (
-      (0, vals.format('cpu: {tor_cpu}% tor, {nyx_cpu}% nyx')),
-      (27, vals.format('mem: {memory} ({memory_percent}%)')),
-      (47, vals.format('pid: {pid}')),
-      (59, 'uptime: %s' % uptime),
-    )
-
-    for (start, label) in sys_fields:
-      if width >= start + len(label):
-        self.addstr(y, x + start, label)
-      else:
-        break
-
-  def _draw_fingerprint_and_fd_usage(self, x, y, width, vals):
-    """
-    Presents our fingerprint, and our file descriptor usage if we're running
-    out...
-
-      fingerprint: 1A94D1A794FCB2F8B6CBC179EF8FDD4008A98D3B, file desc: 900 / 1000 (90%)
-    """
-
-    initial_x, space_left = x, width
-
-    x = self.addstr(y, x, vals.format('fingerprint: {fingerprint}', width))
-    space_left -= x - initial_x
-
-    if space_left >= 30 and vals.fd_used and vals.fd_limit != -1:
-      fd_percent = 100 * vals.fd_used / vals.fd_limit
-
-      if fd_percent >= SHOW_FD_THRESHOLD:
-        if fd_percent >= 95:
-          percentage_format = (curses.A_BOLD, 'red')
-        elif fd_percent >= 90:
-          percentage_format = ('red',)
-        elif fd_percent >= 60:
-          percentage_format = ('yellow',)
-        else:
-          percentage_format = ()
-
-        x = self.addstr(y, x, ', file descriptors' if space_left >= 37 else ', file desc')
-        x = self.addstr(y, x, vals.format(': {fd_used} / {fd_limit} ('))
-        x = self.addstr(y, x, '%i%%' % fd_percent, *percentage_format)
-        self.addstr(y, x, ')')
-
-  def _draw_flags(self, x, y, width, vals):
-    """
-    Presents flags held by our relay...
-
-      flags: Running, Valid
-    """
-
-    x = self.addstr(y, x, 'flags: ')
-
-    if vals.flags:
-      for i, flag in enumerate(vals.flags):
-        flag_color = CONFIG['attr.flag_colors'].get(flag, 'white')
-        x = self.addstr(y, x, flag, curses.A_BOLD, flag_color)
-
-        if i < len(vals.flags) - 1:
-          x = self.addstr(y, x, ', ')
-    else:
-      self.addstr(y, x, 'none', curses.A_BOLD, 'cyan')
-
-  def _draw_exit_policy(self, x, y, width, vals):
-    """
-    Presents our exit policy...
-
-      exit policy: reject *:*
-    """
-
-    x = self.addstr(y, x, 'exit policy: ')
-
-    if not vals.exit_policy:
-      return
-
-    rules = list(vals.exit_policy.strip_private().strip_default())
-
-    for i, rule in enumerate(rules):
-      policy_color = 'green' if rule.is_accept else 'red'
-      x = self.addstr(y, x, str(rule), curses.A_BOLD, policy_color)
-
-      if i < len(rules) - 1:
-        x = self.addstr(y, x, ', ')
-
-    if vals.exit_policy.has_default():
-      if rules:
-        x = self.addstr(y, x, ', ')
-
-      self.addstr(y, x, '<default>', curses.A_BOLD, 'cyan')
-
-  def _draw_newnym_option(self, x, y, width, vals):
-    """
-    Provide a notice for requiesting a new identity, and time until it's next
-    available if in the process of building circuits.
-    """
-
-    if vals.newnym_wait == 0:
-      self.addstr(y, x, "press 'n' for a new identity")
-    else:
-      plural = 's' if vals.newnym_wait > 1 else ''
-      self.addstr(y, x, 'building circuits, available again in %i second%s' % (vals.newnym_wait, plural))
-
-  def run(self):
-    """
-    Keeps stats updated, checking for new information at a set rate.
-    """
-
-    last_ran = -1
-
-    while not self._halt:
-      if self.is_paused() or not self._vals.is_connected or (time.time() - last_ran) < UPDATE_RATE:
-        with self._pause_condition:
-          if not self._halt:
-            self._pause_condition.wait(0.2)
-
-        continue  # done waiting, try again
-
-      self._update()
-      last_ran = time.time()
-
-  def stop(self):
-    """
-    Halts further resolutions and terminates the thread.
-    """
-
-    with self._pause_condition:
-      self._halt = True
-      self._pause_condition.notifyAll()
-
-  def reset_listener(self, controller, event_type, _):
-    self._update()
-
-    if event_type == State.CLOSED:
-      log.notice('Tor control port closed')
-
-  def _update(self):
-    previous_height = self.get_height()
-    self._vals = get_sampling(self._vals)
-
-    if self._vals.fd_used and self._vals.fd_limit != -1:
-      fd_percent = 100 * self._vals.fd_used / self._vals.fd_limit
-
-      if fd_percent >= 90:
-        log_msg = msg('panel.header.fd_used_at_ninety_percent', percentage = fd_percent)
-        log.log_once('fd_used_at_ninety_percent', log.WARN, log_msg)
-        log.DEDUPLICATION_MESSAGE_IDS.add('fd_used_at_sixty_percent')
-      elif fd_percent >= 60:
-        log_msg = msg('panel.header.fd_used_at_sixty_percent', percentage = fd_percent)
-        log.log_once('fd_used_at_sixty_percent', log.NOTICE, log_msg)
-
-    if self._vals.is_connected:
-      if not self._reported_inactive and (time.time() - self._vals.last_heartbeat) >= 10:
-        self._reported_inactive = True
-        log.notice('Relay unresponsive (last heartbeat: %s)' % time.ctime(self._vals.last_heartbeat))
-      elif self._reported_inactive and (time.time() - self._vals.last_heartbeat) < 10:
-        self._reported_inactive = False
-        log.notice('Relay resumed')
-
-    if previous_height != self.get_height():
-      # We're toggling between being a relay and client, causing the height
-      # of this panel to change. Redraw all content so we don't get
-      # overlapping content.
-
-      nyx.controller.get_controller().redraw()
-    else:
-      self.redraw(True)  # just need to redraw ourselves
-
-
-def get_sampling(last_sampling = None):
-  controller = tor_controller()
-  retrieved = time.time()
-
-  pid = controller.get_pid('')
-  tor_resources = tracker.get_resource_tracker().get_value()
-  nyx_total_cpu_time = sum(os.times()[:3])
-
-  or_listeners = controller.get_listeners(Listener.OR, [])
-  control_listeners = controller.get_listeners(Listener.CONTROL, [])
-
-  if controller.get_conf('HashedControlPassword', None):
-    auth_type = 'password'
-  elif controller.get_conf('CookieAuthentication', None) == '1':
-    auth_type = 'cookie'
-  else:
-    auth_type = 'open'
-
-  try:
-    fd_used = proc.file_descriptors_used(pid)
-  except IOError:
-    fd_used = None
-
-  if last_sampling:
-    nyx_cpu_delta = nyx_total_cpu_time - last_sampling.nyx_total_cpu_time
-    nyx_time_delta = retrieved - last_sampling.retrieved
-
-    python_cpu_time = nyx_cpu_delta / nyx_time_delta
-    sys_call_cpu_time = 0.0  # TODO: add a wrapper around call() to get this
-
-    nyx_cpu = python_cpu_time + sys_call_cpu_time
-  else:
-    nyx_cpu = 0.0
-
-  attr = {
-    'retrieved': retrieved,
-    'is_connected': controller.is_alive(),
-    'connection_time': controller.connection_time(),
-    'last_heartbeat': controller.get_latest_heartbeat(),
-
-    'fingerprint': controller.get_info('fingerprint', 'Unknown'),
-    'nickname': controller.get_conf('Nickname', ''),
-    'newnym_wait': controller.get_newnym_wait(),
-    'exit_policy': controller.get_exit_policy(None),
-    'flags': getattr(controller.get_network_status(default = None), 'flags', []),
-
-    'version': str(controller.get_version('Unknown')).split()[0],
-    'version_status': controller.get_info('status/version/current', 'Unknown'),
-
-    'address': or_listeners[0][0] if (or_listeners and or_listeners[0][0] != '0.0.0.0') else controller.get_info('address', 'Unknown'),
-    'or_port': or_listeners[0][1] if or_listeners else '',
-    'dir_port': controller.get_conf('DirPort', '0'),
-    'control_port': str(control_listeners[0][1]) if control_listeners else None,
-    'socket_path': controller.get_conf('ControlSocket', None),
-    'is_relay': bool(or_listeners),
-
-    'auth_type': auth_type,
-    'pid': pid,
-    'start_time': system.start_time(pid),
-    'fd_limit': int(controller.get_info('process/descriptor-limit', '-1')),
-    'fd_used': fd_used,
-
-    'nyx_total_cpu_time': nyx_total_cpu_time,
-    'tor_cpu': '%0.1f' % (100 * tor_resources.cpu_sample),
-    'nyx_cpu': nyx_cpu,
-    'memory': str_tools.size_label(tor_resources.memory_bytes) if tor_resources.memory_bytes > 0 else 0,
-    'memory_percent': '%0.1f' % (100 * tor_resources.memory_percent),
-
-    'hostname': os.uname()[1],
-    'platform': '%s %s' % (os.uname()[0], os.uname()[2]),  # [platform name] [version]
-  }
-
-  class Sampling(collections.namedtuple('Sampling', attr.keys())):
-    def __init__(self, **attr):
-      super(Sampling, self).__init__(**attr)
-      self._attr = attr
-
-    def format(self, message, crop_width = None):
-      formatted_msg = message.format(**self._attr)
-
-      if crop_width:
-        formatted_msg = str_tools.crop(formatted_msg, crop_width)
-
-      return formatted_msg
-
-  return Sampling(**attr)
diff --git a/nyx/log_panel.py b/nyx/log_panel.py
deleted file mode 100644
index 708a679..0000000
--- a/nyx/log_panel.py
+++ /dev/null
@@ -1,454 +0,0 @@
-"""
-Panel providing a chronological log of events its been configured to listen
-for. This provides prepopulation from the log file and supports filtering by
-regular expressions.
-"""
-
-import os
-import time
-import curses
-import threading
-
-import stem.response.events
-
-import nyx.arguments
-import nyx.popups
-import nyx.util.log
-
-from nyx.util import join, panel, tor_controller, ui_tools
-from stem.util import conf, log
-
-
-def conf_handler(key, value):
-  if key == 'features.log.prepopulateReadLimit':
-    return max(0, value)
-  elif key == 'features.log.maxRefreshRate':
-    return max(10, value)
-  elif key == 'cache.log_panel.size':
-    return max(1000, value)
-
-
-CONFIG = conf.config_dict('nyx', {
-  'attr.log_color': {},
-  'cache.log_panel.size': 1000,
-  'features.logFile': '',
-  'features.log.showDuplicateEntries': False,
-  'features.log.prepopulate': True,
-  'features.log.prepopulateReadLimit': 5000,
-  'features.log.maxRefreshRate': 300,
-  'features.log.regex': [],
-  'msg.misc.event_types': '',
-  'startup.events': 'N3',
-}, conf_handler)
-
-# The height of the drawn content is estimated based on the last time we redrew
-# the panel. It's chiefly used for scrolling and the bar indicating its
-# position. Letting the estimate be too inaccurate results in a display bug, so
-# redraws the display if it's off by this threshold.
-
-CONTENT_HEIGHT_REDRAW_THRESHOLD = 3
-
-# Log buffer so we start collecting stem/nyx events when imported. This is used
-# to make our LogPanel when curses initializes.
-
-stem_logger = log.get_logger()
-NYX_LOGGER = log.LogBuffer(log.Runlevel.DEBUG, yield_records = True)
-stem_logger.addHandler(NYX_LOGGER)
-
-
-class LogPanel(panel.Panel, threading.Thread):
-  """
-  Listens for and displays tor, nyx, and stem events. This prepopulates
-  from tor's log file if it exists.
-  """
-
-  def __init__(self, stdscr):
-    panel.Panel.__init__(self, stdscr, 'log', 0)
-    threading.Thread.__init__(self)
-    self.setDaemon(True)
-
-    logged_events = nyx.arguments.expand_events(CONFIG['startup.events'])
-    self._event_log = nyx.util.log.LogGroup(CONFIG['cache.log_panel.size'], group_by_day = True)
-    self._event_types = nyx.util.log.listen_for_events(self._register_tor_event, logged_events)
-    self._log_file = nyx.util.log.LogFileOutput(CONFIG['features.logFile'])
-    self._filter = nyx.util.log.LogFilters(initial_filters = CONFIG['features.log.regex'])
-    self._show_duplicates = CONFIG['features.log.showDuplicateEntries']
-
-    self.set_pause_attr('_event_log')
-
-    self._halt = False  # terminates thread if true
-    self._pause_condition = threading.Condition()
-    self._has_new_event = False
-
-    # fetches past tor events from log file, if available
-
-    if CONFIG['features.log.prepopulate']:
-      log_location = nyx.util.log.log_file_path(tor_controller())
-
-      if log_location:
-        try:
-          for entry in reversed(list(nyx.util.log.read_tor_log(log_location, CONFIG['features.log.prepopulateReadLimit']))):
-            if entry.type in self._event_types:
-              self._event_log.add(entry)
-        except IOError as exc:
-          log.info('Unable to read log located at %s: %s' % (log_location, exc))
-        except ValueError as exc:
-          log.info(str(exc))
-
-    self._last_content_height = len(self._event_log)  # height of the rendered content when last drawn
-    self._scroll = 0
-
-    # merge NYX_LOGGER into us, and listen for its future events
-
-    for event in NYX_LOGGER:
-      self._register_nyx_event(event)
-
-    NYX_LOGGER.emit = self._register_nyx_event
-
-  def set_duplicate_visability(self, is_visible):
-    """
-    Sets if duplicate log entries are collaped or expanded.
-
-    :param bool is_visible: if **True** all log entries are shown, otherwise
-      they're deduplicated
-    """
-
-    self._show_duplicates = is_visible
-
-  def get_filter(self):
-    """
-    Provides our currently selected regex filter.
-    """
-
-    return self._filter
-
-  def show_filter_prompt(self):
-    """
-    Prompts the user to add a new regex filter.
-    """
-
-    regex_input = nyx.popups.input_prompt('Regular expression: ')
-
-    if regex_input:
-      self._filter.select(regex_input)
-
-  def show_event_selection_prompt(self):
-    """
-    Prompts the user to select the events being listened for.
-    """
-
-    # allow user to enter new types of events to log - unchanged if left blank
-
-    with nyx.popups.popup_window(16, 80) as (popup, width, height):
-      if popup:
-        # displays the available flags
-
-        popup.win.box()
-        popup.addstr(0, 0, 'Event Types:', curses.A_STANDOUT)
-        event_lines = CONFIG['msg.misc.event_types'].split('\n')
-
-        for i in range(len(event_lines)):
-          popup.addstr(i + 1, 1, event_lines[i][6:])
-
-        popup.win.refresh()
-
-        user_input = nyx.popups.input_prompt('Events to log: ')
-
-        if user_input:
-          try:
-            user_input = user_input.replace(' ', '')  # strip spaces
-            event_types = nyx.arguments.expand_events(user_input)
-
-            if event_types != self._event_types:
-              self._event_types = nyx.util.log.listen_for_events(self._register_tor_event, event_types)
-              self.redraw(True)
-          except ValueError as exc:
-            nyx.popups.show_msg('Invalid flags: %s' % str(exc), 2)
-
-  def show_snapshot_prompt(self):
-    """
-    Lets user enter a path to take a snapshot, canceling if left blank.
-    """
-
-    path_input = nyx.popups.input_prompt('Path to save log snapshot: ')
-
-    if path_input:
-      try:
-        self.save_snapshot(path_input)
-        nyx.popups.show_msg('Saved: %s' % path_input, 2)
-      except IOError as exc:
-        nyx.popups.show_msg('Unable to save snapshot: %s' % exc, 2)
-
-  def clear(self):
-    """
-    Clears the contents of the event log.
-    """
-
-    self._event_log = nyx.util.log.LogGroup(CONFIG['cache.log_panel.size'], group_by_day = True)
-    self.redraw(True)
-
-  def save_snapshot(self, path):
-    """
-    Saves the log events currently being displayed to the given path. This
-    takes filers into account. This overwrites the file if it already exists.
-
-    :param str path: path where to save the log snapshot
-
-    :raises: **IOError** if unsuccessful
-    """
-
-    path = os.path.abspath(os.path.expanduser(path))
-
-    # make dir if the path doesn't already exist
-
-    base_dir = os.path.dirname(path)
-
-    try:
-      if not os.path.exists(base_dir):
-        os.makedirs(base_dir)
-    except OSError as exc:
-      raise IOError("unable to make directory '%s'" % base_dir)
-
-    event_log = list(self._event_log)
-    event_filter = self._filter.clone()
-
-    with open(path, 'w') as snapshot_file:
-      try:
-        for entry in reversed(event_log):
-          if event_filter.match(entry.display_message):
-            snapshot_file.write(entry.display_message + '\n')
-      except Exception as exc:
-        raise IOError("unable to write to '%s': %s" % (path, exc))
-
-  def handle_key(self, key):
-    if key.is_scroll():
-      page_height = self.get_preferred_size()[0] - 1
-      new_scroll = ui_tools.get_scroll_position(key, self._scroll, page_height, self._last_content_height)
-
-      if self._scroll != new_scroll:
-        self._scroll = new_scroll
-        self.redraw(True)
-    elif key.match('u'):
-      self.set_duplicate_visability(not self._show_duplicates)
-      self.redraw(True)
-    elif key.match('c'):
-      msg = 'This will clear the log. Are you sure (c again to confirm)?'
-      key_press = nyx.popups.show_msg(msg, attr = curses.A_BOLD)
-
-      if key_press.match('c'):
-        self.clear()
-    elif key.match('f'):
-      with panel.CURSES_LOCK:
-        initial_selection = 1 if self._filter.selection() else 0
-        options = ['None'] + self._filter.latest_selections() + ['New...']
-        selection = nyx.popups.show_menu('Log Filter:', options, initial_selection)
-
-        if selection == 0:
-          self._filter.select(None)
-        elif selection == len(options) - 1:
-          # selected 'New...' option - prompt user to input regular expression
-          self.show_filter_prompt()
-        elif selection != -1:
-          self._filter.select(self._filter.latest_selections()[selection - 1])
-    elif key.match('e'):
-      self.show_event_selection_prompt()
-    elif key.match('a'):
-      self.show_snapshot_prompt()
-    else:
-      return False
-
-    return True
-
-  def get_help(self):
-    return [
-      ('up arrow', 'scroll log up a line', None),
-      ('down arrow', 'scroll log down a line', None),
-      ('a', 'save snapshot of the log', None),
-      ('e', 'change logged events', None),
-      ('f', 'log regex filter', 'enabled' if self._filter.selection() else 'disabled'),
-      ('u', 'duplicate log entries', 'visible' if self._show_duplicates else 'hidden'),
-      ('c', 'clear event log', None),
-    ]
-
-  def draw(self, width, height):
-    self._scroll = max(0, min(self._scroll, self._last_content_height - height + 1))
-
-    event_log = list(self.get_attr('_event_log'))
-    event_filter = self._filter.clone()
-    event_types = list(self._event_types)
-    scroll = int(self._scroll)
-    last_content_height = self._last_content_height
-    show_duplicates = self._show_duplicates
-
-    is_scrollbar_visible = last_content_height > height - 1
-
-    if is_scrollbar_visible:
-      self.add_scroll_bar(scroll, scroll + height - 1, last_content_height, 1)
-
-    x, y = 3 if is_scrollbar_visible else 1, 1 - scroll
-
-    # group entries by date, filtering out those that aren't visible
-
-    day_to_entries, today = {}, nyx.util.log.day_count(time.time())
-
-    for entry in event_log:
-      if entry.is_duplicate and not show_duplicates:
-        continue  # deduplicated message
-      elif not event_filter.match(entry.display_message):
-        continue  # filter doesn't match log message
-
-      day_to_entries.setdefault(entry.day_count(), []).append(entry)
-
-    for day in sorted(day_to_entries.keys(), reverse = True):
-      if day == today:
-        for entry in day_to_entries[day]:
-          y = self._draw_entry(x, y, width, entry, show_duplicates)
-      else:
-        original_y, y = y, y + 1
-
-        for entry in day_to_entries[day]:
-          y = self._draw_entry(x, y, width, entry, show_duplicates)
-
-        ui_tools.draw_box(self, original_y, x - 1, width - x + 1, y - original_y + 1, curses.A_BOLD, 'yellow')
-        time_label = time.strftime(' %B %d, %Y ', time.localtime(day_to_entries[day][0].timestamp))
-        self.addstr(original_y, x + 1, time_label, curses.A_BOLD, curses.A_BOLD, 'yellow')
-
-        y += 1
-
-    # drawing the title after the content, so we'll clear content from the top line
-
-    if self.is_title_visible():
-      self._draw_title(width, event_types, event_filter)
-
-    # redraw the display if...
-    # - last_content_height was off by too much
-    # - we're off the bottom of the page
-
-    new_content_height = y + scroll - 1
-    content_height_delta = abs(last_content_height - new_content_height)
-    force_redraw, force_redraw_reason = True, ''
-
-    if content_height_delta >= CONTENT_HEIGHT_REDRAW_THRESHOLD:
-      force_redraw_reason = 'estimate was off by %i' % content_height_delta
-    elif new_content_height > height and self._scroll + height - 1 > new_content_height:
-      force_redraw_reason = 'scrolled off the bottom of the page'
-    elif not is_scrollbar_visible and new_content_height > height - 1:
-      force_redraw_reason = "scroll bar wasn't previously visible"
-    elif is_scrollbar_visible and new_content_height <= height - 1:
-      force_redraw_reason = "scroll bar shouldn't be visible"
-    else:
-      force_redraw = False
-
-    self._last_content_height = new_content_height
-    self._has_new_event = False
-
-    if force_redraw:
-      log.debug('redrawing the log panel with the corrected content height (%s)' % force_redraw_reason)
-      self.redraw(True)
-
-  def _draw_title(self, width, event_types, event_filter):
-    """
-    Panel title with the event types we're logging and our regex filter if set.
-    """
-
-    self.addstr(0, 0, ' ' * width)  # clear line
-    title_comp = list(nyx.util.log.condense_runlevels(*event_types))
-
-    if event_filter.selection():
-      title_comp.append('filter: %s' % event_filter.selection())
-
-    title_comp_str = join(title_comp, ', ', width - 10)
-    title = 'Events (%s):' % title_comp_str if title_comp_str else 'Events:'
-
-    self.addstr(0, 0, title, curses.A_STANDOUT)
-
-  def _draw_entry(self, x, y, width, entry, show_duplicates):
-    """
-    Presents a log entry with line wrapping.
-    """
-
-    min_x, msg = x + 2, entry.display_message
-    boldness = curses.A_BOLD if 'ERR' in entry.type else curses.A_NORMAL  # emphasize ERR messages
-    color = CONFIG['attr.log_color'].get(entry.type, 'white')
-
-    for line in msg.splitlines():
-      x, y = self.addstr_wrap(y, x, line, width, min_x, boldness, color)
-
-    if entry.duplicates and not show_duplicates:
-      duplicate_count = len(entry.duplicates) - 1
-      plural = 's' if duplicate_count > 1 else ''
-      duplicate_msg = ' [%i duplicate%s hidden]' % (duplicate_count, plural)
-      x, y = self.addstr_wrap(y, x, duplicate_msg, width, min_x, curses.A_BOLD, 'green')
-
-    return y + 1
-
-  def run(self):
-    """
-    Redraws the display, coalescing updates if events are rapidly logged (for
-    instance running at the DEBUG runlevel) while also being immediately
-    responsive if additions are less frequent.
-    """
-
-    last_ran, last_day = -1, nyx.util.log.day_count(time.time())
-
-    while not self._halt:
-      current_day = nyx.util.log.day_count(time.time())
-      time_since_reset = time.time() - last_ran
-      max_log_update_rate = CONFIG['features.log.maxRefreshRate'] / 1000.0
-
-      sleep_time = 0
-
-      if (not self._has_new_event and last_day == current_day) or self.is_paused():
-        sleep_time = 5
-      elif time_since_reset < max_log_update_rate:
-        sleep_time = max(0.05, max_log_update_rate - time_since_reset)
-
-      if sleep_time:
-        with self._pause_condition:
-          if not self._halt:
-            self._pause_condition.wait(sleep_time)
-
-        continue
-
-      last_ran, last_day = time.time(), current_day
-      self.redraw(True)
-
-  def stop(self):
-    """
-    Halts further updates and terminates the thread.
-    """
-
-    with self._pause_condition:
-      self._halt = True
-      self._pause_condition.notifyAll()
-
-  def _register_tor_event(self, event):
-    msg = ' '.join(str(event).split(' ')[1:])
-
-    if isinstance(event, stem.response.events.BandwidthEvent):
-      msg = 'READ: %i, WRITTEN: %i' % (event.read, event.written)
-    elif isinstance(event, stem.response.events.LogEvent):
-      msg = event.message
-
-    self._register_event(nyx.util.log.LogEntry(event.arrived_at, event.type, msg))
-
-  def _register_nyx_event(self, record):
-    if record.levelname == 'WARNING':
-      record.levelname = 'WARN'
-
-    self._register_event(nyx.util.log.LogEntry(int(record.created), 'NYX_%s' % record.levelname, record.msg))
-
-  def _register_event(self, event):
-    if event.type not in self._event_types:
-      return
-
-    self._event_log.add(event)
-    self._log_file.write(event.display_message)
-
-    # notifies the display that it has new content
-
-    if self._filter.match(event.display_message):
-      self._has_new_event = True
-
-      with self._pause_condition:
-        self._pause_condition.notifyAll()
diff --git a/nyx/menu/actions.py b/nyx/menu/actions.py
index 0105615..222e3e7 100644
--- a/nyx/menu/actions.py
+++ b/nyx/menu/actions.py
@@ -4,10 +4,10 @@ Generates the menu for nyx, binding options with their related actions.
import functools
-import nyx.popups
 import nyx.controller
+import nyx.panel.graph
+import nyx.popups
 import nyx.menu.item
-import nyx.graph_panel
 import nyx.util.tracker
from nyx.util import tor_controller, ui_tools
@@ -167,7 +167,7 @@ def make_graph_menu(graph_panel):
   interval_menu = nyx.menu.item.Submenu('Interval')
   interval_group = nyx.menu.item.SelectionGroup(functools.partial(setattr, graph_panel, 'update_interval'), graph_panel.update_interval)
-  for interval in nyx.graph_panel.Interval:
+  for interval in nyx.panel.graph.Interval:
     interval_menu.add(nyx.menu.item.SelectionMenuItem(interval, interval_group, interval))
graph_menu.add(interval_menu)
@@ -177,7 +177,7 @@ def make_graph_menu(graph_panel):
   bounds_menu = nyx.menu.item.Submenu('Bounds')
   bounds_group = nyx.menu.item.SelectionGroup(functools.partial(setattr, graph_panel, 'bounds_type'), graph_panel.bounds_type)
-  for bounds_type in nyx.graph_panel.Bounds:
+  for bounds_type in nyx.panel.graph.Bounds:
     bounds_menu.add(nyx.menu.item.SelectionMenuItem(bounds_type, bounds_group, bounds_type))
graph_menu.add(bounds_menu)
diff --git a/nyx/panel/__init__.py b/nyx/panel/__init__.py
new file mode 100644
index 0000000..0f25fac
--- /dev/null
+++ b/nyx/panel/__init__.py
@@ -0,0 +1,11 @@
+"""
+Panels consisting the nyx interface.
+"""
+
+__all__ = [
+  'config',
+  'connection',
+  'header',
+  'log',
+  'torrc',
+]
diff --git a/nyx/panel/config.py b/nyx/panel/config.py
new file mode 100644
index 0000000..2352fe7
--- /dev/null
+++ b/nyx/panel/config.py
@@ -0,0 +1,357 @@
+"""
+Panel presenting the configuration state for tor or nyx. Options can be edited
+and the resulting configuration files saved.
+"""
+
+import curses
+import os
+
+import nyx.controller
+import nyx.popups
+
+import stem.control
+import stem.manual
+
+from nyx.util import DATA_DIR, panel, tor_controller, ui_tools
+
+from stem.util import conf, enum, log, str_tools
+
+SortAttr = enum.Enum('NAME', 'VALUE', 'VALUE_TYPE', 'CATEGORY', 'USAGE', 'SUMMARY', 'DESCRIPTION', 'MAN_PAGE_ENTRY', 'IS_SET')
+
+DETAILS_HEIGHT = 8
+NAME_WIDTH = 25
+VALUE_WIDTH = 15
+
+
+def conf_handler(key, value):
+  if key == 'features.config.order':
+    return conf.parse_enum_csv(key, value[0], SortAttr, 3)
+
+
+CONFIG = conf.config_dict('nyx', {
+  'attr.config.category_color': {},
+  'attr.config.sort_color': {},
+  'features.config.order': [SortAttr.MAN_PAGE_ENTRY, SortAttr.NAME, SortAttr.IS_SET],
+  'features.config.state.showPrivateOptions': False,
+  'features.config.state.showVirtualOptions': False,
+}, conf_handler)
+
+
+class ConfigEntry(object):
+  """
+  Configuration option presented in the panel.
+
+  :var str name: name of the configuration option
+  :var str value_type: type of value
+  :var stem.manual.ConfigOption manual: manual information about the option
+  """
+
+  def __init__(self, name, value_type, manual):
+    self.name = name
+    self.value_type = value_type
+    self.manual = manual.config_options.get(name, stem.manual.ConfigOption(name))
+    self._index = manual.config_options.keys().index(name) if name in manual.config_options else 99999
+
+  def value(self):
+    """
+    Provides the value of this configuration option.
+
+    :returns: **str** representation of the current config value
+    """
+
+    values = tor_controller().get_conf(self.name, [], True)
+
+    if not values:
+      return '<none>'
+    elif self.value_type == 'Boolean' and values[0] in ('0', '1'):
+      return 'False' if values[0] == '0' else 'True'
+    elif self.value_type == 'DataSize' and values[0].isdigit():
+      return str_tools.size_label(int(values[0]))
+    elif self.value_type == 'TimeInterval' and values[0].isdigit():
+      return str_tools.time_label(int(values[0]), is_long = True)
+    else:
+      return ', '.join(values)
+
+  def is_set(self):
+    """
+    Checks if the configuration option has a custom value.
+
+    :returns: **True** if the option has a custom value, **False** otherwise
+    """
+
+    return tor_controller().is_set(self.name, False)
+
+  def sort_value(self, attr):
+    """
+    Provides a heuristic for sorting by a given value.
+
+    :param SortAttr attr: sort attribute to provide a heuristic for
+
+    :returns: comparable value for sorting
+    """
+
+    if attr == SortAttr.CATEGORY:
+      return self.manual.category
+    elif attr == SortAttr.NAME:
+      return self.name
+    elif attr == SortAttr.VALUE:
+      return self.value()
+    elif attr == SortAttr.VALUE_TYPE:
+      return self.value_type
+    elif attr == SortAttr.USAGE:
+      return self.manual.usage
+    elif attr == SortAttr.SUMMARY:
+      return self.manual.summary
+    elif attr == SortAttr.DESCRIPTION:
+      return self.manual.description
+    elif attr == SortAttr.MAN_PAGE_ENTRY:
+      return self._index
+    elif attr == SortAttr.IS_SET:
+      return not self.is_set()
+
+
+class ConfigPanel(panel.Panel):
+  """
+  Editor for tor's configuration.
+  """
+
+  def __init__(self, stdscr):
+    panel.Panel.__init__(self, stdscr, 'configuration', 0)
+
+    self._contents = []
+    self._scroller = ui_tools.Scroller(True)
+    self._sort_order = CONFIG['features.config.order']
+    self._show_all = False  # show all options, or just the important ones
+
+    cached_manual_path = os.path.join(DATA_DIR, 'manual')
+
+    if os.path.exists(cached_manual_path):
+      manual = stem.manual.Manual.from_cache(cached_manual_path)
+    else:
+      try:
+        manual = stem.manual.Manual.from_man()
+
+        try:
+          manual.save(cached_manual_path)
+        except IOError as exc:
+          log.debug("Unable to cache manual information to '%s'. This is fine, but means starting Nyx takes a little longer than usual: " % (cached_manual_path, exc))
+      except IOError as exc:
+        log.debug("Unable to use 'man tor' to get information about config options (%s), using bundled information instead" % exc)
+        manual = stem.manual.Manual.from_cache()
+
+    try:
+      for line in tor_controller().get_info('config/names').splitlines():
+        # Lines of the form "<option> <type>[ <documentation>]". Documentation
+        # was apparently only in old tor versions like 0.2.1.25.
+
+        if ' ' not in line:
+          continue
+
+        line_comp = line.split()
+        name, value_type = line_comp[0], line_comp[1]
+
+        # skips private and virtual entries if not configured to show them
+
+        if name.startswith('__') and not CONFIG['features.config.state.showPrivateOptions']:
+          continue
+        elif value_type == 'Virtual' and not CONFIG['features.config.state.showVirtualOptions']:
+          continue
+
+        self._contents.append(ConfigEntry(name, value_type, manual))
+
+      self._contents = sorted(self._contents, key = lambda entry: [entry.sort_value(field) for field in self._sort_order])
+    except stem.ControllerError as exc:
+      log.warn('Unable to determine the configuration options tor supports: %s' % exc)
+
+  def show_sort_dialog(self):
+    """
+    Provides the dialog for sorting our configuration options.
+    """
+
+    sort_colors = dict([(attr, CONFIG['attr.config.sort_color'].get(attr, 'white')) for attr in SortAttr])
+    results = nyx.popups.show_sort_dialog('Config Option Ordering:', SortAttr, self._sort_order, sort_colors)
+
+    if results:
+      self._sort_order = results
+      self._contents = sorted(self._contents, key = lambda entry: [entry.sort_value(field) for field in self._sort_order])
+
+  def show_write_dialog(self):
+    """
+    Confirmation dialog for saving tor's configuration.
+    """
+
+    selection, controller = 1, tor_controller()
+    config_text = controller.get_info('config-text', None)
+    config_lines = config_text.splitlines() if config_text else []
+
+    with nyx.popups.popup_window(len(config_lines) + 2) as (popup, width, height):
+      if not popup or height <= 2:
+        return
+
+      while True:
+        height, width = popup.get_preferred_size()  # allow us to be resized
+        popup.win.erase()
+
+        for i, full_line in enumerate(config_lines):
+          line = str_tools.crop(full_line, width - 2)
+          option, arg = line.split(' ', 1) if ' ' in line else (line, '')
+
+          popup.addstr(i + 1, 1, option, curses.A_BOLD, 'green')
+          popup.addstr(i + 1, len(option) + 2, arg, curses.A_BOLD, 'cyan')
+
+        x = width - 16
+
+        for i, option in enumerate(['Save', 'Cancel']):
+          x = popup.addstr(height - 2, x, '[')
+          x = popup.addstr(height - 2, x, option, curses.A_BOLD, curses.A_STANDOUT if i == selection else curses.A_NORMAL)
+          x = popup.addstr(height - 2, x, '] ')
+
+        popup.win.box()
+        popup.addstr(0, 0, 'Torrc to save:', curses.A_STANDOUT)
+        popup.win.refresh()
+
+        key = nyx.controller.get_controller().key_input()
+
+        if key.match('left'):
+          selection = max(0, selection - 1)
+        elif key.match('right'):
+          selection = min(1, selection + 1)
+        elif key.is_selection():
+          if selection == 0:
+            try:
+              controller.save_conf()
+              nyx.popups.show_msg('Saved configuration to %s' % controller.get_info('config-file', '<unknown>'), 2)
+            except IOError as exc:
+              nyx.popups.show_msg('Unable to save configuration (%s)' % exc.strerror, 2)
+
+          break
+        elif key.match('esc'):
+          break  # esc - cancel
+
+  def handle_key(self, key):
+    if key.is_scroll():
+      page_height = self.get_preferred_size()[0] - DETAILS_HEIGHT
+      is_changed = self._scroller.handle_key(key, self._get_config_options(), page_height)
+
+      if is_changed:
+        self.redraw(True)
+    elif key.is_selection():
+      selection = self._scroller.get_cursor_selection(self._get_config_options())
+      initial_value = selection.value() if selection.is_set() else ''
+      new_value = nyx.popups.input_prompt('%s Value (esc to cancel): ' % selection.name, initial_value)
+
+      if new_value != initial_value:
+        try:
+          if selection.value_type == 'Boolean':
+            # if the value's a boolean then allow for 'true' and 'false' inputs
+
+            if new_value.lower() == 'true':
+              new_value = '1'
+            elif new_value.lower() == 'false':
+              new_value = '0'
+          elif selection.value_type == 'LineList':
+            new_value = new_value.split(',')  # set_conf accepts list inputs
+
+          tor_controller().set_conf(selection.name, new_value)
+          self.redraw(True)
+        except Exception as exc:
+          nyx.popups.show_msg('%s (press any key)' % exc)
+    elif key.match('a'):
+      self._show_all = not self._show_all
+      self.redraw(True)
+    elif key.match('s'):
+      self.show_sort_dialog()
+    elif key.match('w'):
+      self.show_write_dialog()
+    else:
+      return False
+
+    return True
+
+  def get_help(self):
+    return [
+      ('up arrow', 'scroll up a line', None),
+      ('down arrow', 'scroll down a line', None),
+      ('page up', 'scroll up a page', None),
+      ('page down', 'scroll down a page', None),
+      ('enter', 'edit configuration option', None),
+      ('w', 'write torrc', None),
+      ('a', 'toggle filtering', None),
+      ('s', 'sort ordering', None),
+    ]
+
+  def draw(self, width, height):
+    contents = self._get_config_options()
+    selection = self._scroller.get_cursor_selection(contents)
+    scroll_location = self._scroller.get_scroll_location(contents, height - DETAILS_HEIGHT)
+    is_scrollbar_visible = len(contents) > height - DETAILS_HEIGHT
+
+    if selection is not None:
+      self._draw_selection_details(selection, width)
+
+    if self.is_title_visible():
+      hidden_msg = "press 'a' to hide most options" if self._show_all else "press 'a' to show all options"
+      self.addstr(0, 0, 'Tor Configuration (%s):' % hidden_msg, curses.A_STANDOUT)
+
+    scroll_offset = 1
+
+    if is_scrollbar_visible:
+      scroll_offset = 3
+      self.add_scroll_bar(scroll_location, scroll_location + height - DETAILS_HEIGHT, len(contents), DETAILS_HEIGHT)
+
+      if selection is not None:
+        self.addch(DETAILS_HEIGHT - 1, 1, curses.ACS_TTEE)
+
+    # Description column can grow up to eighty characters. After that any extra
+    # space goes to the value.
+
+    description_width = max(0, width - scroll_offset - NAME_WIDTH - VALUE_WIDTH - 2)
+
+    if description_width > 80:
+      value_width = VALUE_WIDTH + (description_width - 80)
+      description_width = 80
+    else:
+      value_width = VALUE_WIDTH
+
+    for i, entry in enumerate(contents[scroll_location:]):
+      attr = nyx.util.ui_tools.get_color(CONFIG['attr.config.category_color'].get(entry.manual.category, 'white'))
+      attr |= curses.A_BOLD if entry.is_set() else curses.A_NORMAL
+      attr |= curses.A_STANDOUT if entry == selection else curses.A_NORMAL
+
+      option_label = str_tools.crop(entry.name, NAME_WIDTH).ljust(NAME_WIDTH + 1)
+      value_label = str_tools.crop(entry.value(), value_width).ljust(value_width + 1)
+      summary_label = str_tools.crop(entry.manual.summary, description_width).ljust(description_width)
+
+      self.addstr(DETAILS_HEIGHT + i, scroll_offset, option_label + value_label + summary_label, attr)
+
+      if DETAILS_HEIGHT + i >= height:
+        break
+
+  def _get_config_options(self):
+    return self._contents if self._show_all else filter(lambda entry: stem.manual.is_important(entry.name) or entry.is_set(), self._contents)
+
+  def _draw_selection_details(self, selection, width):
+    """
+    Shows details of the currently selected option.
+    """
+
+    description = 'Description: %s' % (selection.manual.description)
+    attr = ', '.join(('custom' if selection.is_set() else 'default', selection.value_type, 'usage: %s' % selection.manual.usage))
+    selected_color = CONFIG['attr.config.category_color'].get(selection.manual.category, 'white')
+    ui_tools.draw_box(self, 0, 0, width, DETAILS_HEIGHT)
+
+    self.addstr(1, 2, '%s (%s Option)' % (selection.name, selection.manual.category), curses.A_BOLD, selected_color)
+    self.addstr(2, 2, 'Value: %s (%s)' % (selection.value(), str_tools.crop(attr, width - len(selection.value()) - 13)), curses.A_BOLD, selected_color)
+
+    for i in range(DETAILS_HEIGHT - 4):
+      if not description:
+        break  # done writing description
+
+      line, description = description.split('\n', 1) if '\n' in description else (description, '')
+
+      if i < DETAILS_HEIGHT - 5:
+        line, remainder = str_tools.crop(line, width - 3, 4, 4, str_tools.Ending.HYPHEN, True)
+        description = '  ' + remainder.strip() + description
+        self.addstr(3 + i, 2, line, curses.A_BOLD, selected_color)
+      else:
+        self.addstr(3 + i, 2, str_tools.crop(line, width - 3, 4, 4), curses.A_BOLD, selected_color)
diff --git a/nyx/panel/connection.py b/nyx/panel/connection.py
new file mode 100644
index 0000000..e28f531
--- /dev/null
+++ b/nyx/panel/connection.py
@@ -0,0 +1,706 @@
+"""
+Listing of the currently established connections tor has made.
+"""
+
+import re
+import time
+import collections
+import curses
+import itertools
+import threading
+
+import nyx.popups
+import nyx.util.tracker
+import nyx.util.ui_tools
+
+from nyx.util import panel, tor_controller, ui_tools
+
+from stem.control import Listener
+from stem.util import datetime_to_unix, conf, connection, enum, str_tools
+
+try:
+  # added in python 3.2
+  from functools import lru_cache
+except ImportError:
+  from stem.util.lru_cache import lru_cache
+
+# height of the detail panel content, not counting top and bottom border
+
+DETAILS_HEIGHT = 7
+
+EXIT_USAGE_WIDTH = 15
+UPDATE_RATE = 5  # rate in seconds at which we refresh
+
+# cached information from our last _update() call
+
+LAST_RETRIEVED_HS_CONF = None
+LAST_RETRIEVED_CIRCUITS = None
+
+# Connection Categories:
+#   Inbound      Relay connection, coming to us.
+#   Outbound     Relay connection, leaving us.
+#   Exit         Outbound relay connection leaving the Tor network.
+#   Hidden       Connections to a hidden service we're providing.
+#   Socks        Socks connections for applications using Tor.
+#   Circuit      Circuits our tor client has created.
+#   Directory    Fetching tor consensus information.
+#   Control      Tor controller (nyx, vidalia, etc).
+
+Category = enum.Enum('INBOUND', 'OUTBOUND', 'EXIT', 'HIDDEN', 'SOCKS', 'CIRCUIT', 'DIRECTORY', 'CONTROL')
+SortAttr = enum.Enum('CATEGORY', 'UPTIME', 'IP_ADDRESS', 'PORT', 'FINGERPRINT', 'NICKNAME', 'COUNTRY')
+LineType = enum.Enum('CONNECTION', 'CIRCUIT_HEADER', 'CIRCUIT')
+
+Line = collections.namedtuple('Line', [
+  'entry',
+  'line_type',
+  'connection',
+  'circuit',
+  'fingerprint',
+  'nickname',
+  'locale',
+])
+
+
+def conf_handler(key, value):
+  if key == 'features.connection.order':
+    return conf.parse_enum_csv(key, value[0], SortAttr, 3)
+
+
+CONFIG = conf.config_dict('nyx', {
+  'attr.connection.category_color': {},
+  'attr.connection.sort_color': {},
+  'features.connection.resolveApps': True,
+  'features.connection.order': [SortAttr.CATEGORY, SortAttr.IP_ADDRESS, SortAttr.UPTIME],
+  'features.connection.showIps': True,
+}, conf_handler)
+
+
+class Entry(object):
+  @staticmethod
+  @lru_cache()
+  def from_connection(connection):
+    return ConnectionEntry(connection)
+
+  @staticmethod
+  @lru_cache()
+  def from_circuit(circuit):
+    return CircuitEntry(circuit)
+
+  def get_lines(self):
+    """
+    Provides individual lines of connection information.
+
+    :returns: **list** of **ConnectionLine** concerning this entry
+    """
+
+    raise NotImplementedError('should be implemented by subclasses')
+
+  def get_type(self):
+    """
+    Provides our best guess at the type of connection this is.
+
+    :returns: **Category** for the connection's type
+    """
+
+    raise NotImplementedError('should be implemented by subclasses')
+
+  def is_private(self):
+    """
+    Checks if information about this endpoint should be scrubbed. Relaying
+    etiquette (and wiretapping laws) say these are bad things to look at so
+    DON'T CHANGE THIS UNLESS YOU HAVE A DAMN GOOD REASON!
+
+    :returns: **bool** indicating if connection information is sensive or not
+    """
+
+    raise NotImplementedError('should be implemented by subclasses')
+
+  def sort_value(self, attr):
+    """
+    Provides a heuristic for sorting by a given value.
+
+    :param SortAttr attr: sort attribute to provide a heuristic for
+
+    :returns: comparable value for sorting
+    """
+
+    line = self.get_lines()[0]
+    at_end = 'z' * 20
+
+    if attr == SortAttr.IP_ADDRESS:
+      if self.is_private():
+        return 255 ** 4  # orders at the end
+
+      ip_value = 0
+
+      for octet in line.connection.remote_address.split('.'):
+        ip_value = ip_value * 255 + int(octet)
+
+      return ip_value * 65536 + line.connection.remote_port
+    elif attr == SortAttr.PORT:
+      return line.connection.remote_port
+    elif attr == SortAttr.FINGERPRINT:
+      return line.fingerprint if line.fingerprint else at_end
+    elif attr == SortAttr.NICKNAME:
+      return line.nickname if line.nickname else at_end
+    elif attr == SortAttr.CATEGORY:
+      return Category.index_of(self.get_type())
+    elif attr == SortAttr.UPTIME:
+      return line.connection.start_time
+    elif attr == SortAttr.COUNTRY:
+      return line.locale if (line.locale and not self.is_private()) else at_end
+    else:
+      return ''
+
+
+class ConnectionEntry(Entry):
+  def __init__(self, connection):
+    self._connection = connection
+
+  @lru_cache()
+  def get_lines(self):
+    fingerprint, nickname, locale = None, None, None
+
+    if self.get_type() in (Category.OUTBOUND, Category.CIRCUIT, Category.DIRECTORY, Category.EXIT):
+      fingerprint = nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(self._connection.remote_address).get(self._connection.remote_port)
+
+      if fingerprint:
+        nickname = nyx.util.tracker.get_consensus_tracker().get_relay_nickname(fingerprint)
+        locale = tor_controller().get_info('ip-to-country/%s' % self._connection.remote_address, None)
+
+    return [Line(self, LineType.CONNECTION, self._connection, None, fingerprint, nickname, locale)]
+
+  @lru_cache()
+  def get_type(self):
+    controller = tor_controller()
+
+    if self._connection.local_port in controller.get_ports(Listener.OR, []):
+      return Category.INBOUND
+    elif self._connection.local_port in controller.get_ports(Listener.DIR, []):
+      return Category.INBOUND
+    elif self._connection.local_port in controller.get_ports(Listener.SOCKS, []):
+      return Category.SOCKS
+    elif self._connection.local_port in controller.get_ports(Listener.CONTROL, []):
+      return Category.CONTROL
+
+    if LAST_RETRIEVED_HS_CONF:
+      for hs_config in LAST_RETRIEVED_HS_CONF.values():
+        if self._connection.remote_port == hs_config['HiddenServicePort']:
+          return Category.HIDDEN
+
+    fingerprint = nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(self._connection.remote_address).get(self._connection.remote_port)
+
+    if fingerprint and LAST_RETRIEVED_CIRCUITS:
+      for circ in LAST_RETRIEVED_CIRCUITS:
+        if circ.path and len(circ.path) == 1 and circ.path[0][0] == fingerprint and circ.status == 'BUILT':
+          return Category.DIRECTORY  # one-hop circuit to retrieve directory information
+    else:
+      # not a known relay, might be an exit connection
+
+      exit_policy = controller.get_exit_policy(None)
+
+      if exit_policy and exit_policy.can_exit_to(self._connection.remote_address, self._connection.remote_port):
+        return Category.EXIT
+
+    return Category.OUTBOUND
+
+  @lru_cache()
+  def is_private(self):
+    if not CONFIG['features.connection.showIps']:
+      return True
+
+    if self.get_type() == Category.INBOUND:
+      controller = tor_controller()
+
+      if controller.is_user_traffic_allowed().inbound:
+        return len(nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(self._connection.remote_address)) == 0
+    elif self.get_type() == Category.EXIT:
+      # DNS connections exiting us aren't private (since they're hitting our
+      # resolvers). Everything else is.
+
+      return not (self._connection.remote_port == 53 and self._connection.protocol == 'udp')
+
+    return False  # for everything else this isn't a concern
+
+
+class CircuitEntry(Entry):
+  def __init__(self, circuit):
+    self._circuit = circuit
+
+  @lru_cache()
+  def get_lines(self):
+    def line(fingerprint, line_type):
+      address, port, nickname, locale = '0.0.0.0', 0, None, None
+      consensus_tracker = nyx.util.tracker.get_consensus_tracker()
+
+      if fingerprint is not None:
+        address, port = consensus_tracker.get_relay_address(fingerprint, ('192.168.0.1', 0))
+        nickname = consensus_tracker.get_relay_nickname(fingerprint)
+        locale = tor_controller().get_info('ip-to-country/%s' % address, None)
+
+      connection = nyx.util.tracker.Connection(datetime_to_unix(self._circuit.created), False, '127.0.0.1', 0, address, port, 'tcp', False)
+      return Line(self, line_type, connection, self._circuit, fingerprint, nickname, locale)
+
+    header_line = line(self._circuit.path[-1][0] if self._circuit.status == 'BUILT' else None, LineType.CIRCUIT_HEADER)
+    return [header_line] + [line(fp, LineType.CIRCUIT) for fp, _ in self._circuit.path]
+
+  def get_type(self):
+    return Category.CIRCUIT
+
+  def is_private(self):
+    return False
+
+
+class ConnectionPanel(panel.Panel, threading.Thread):
+  """
+  Listing of connections tor is making, with information correlated against
+  the current consensus and other data sources.
+  """
+
+  def __init__(self, stdscr):
+    panel.Panel.__init__(self, stdscr, 'connections', 0)
+    threading.Thread.__init__(self)
+    self.setDaemon(True)
+
+    self._scroller = ui_tools.Scroller(True)
+    self._entries = []            # last fetched display entries
+    self._show_details = False    # presents the details panel if true
+    self._sort_order = CONFIG['features.connection.order']
+
+    self._last_resource_fetch = -1  # timestamp of the last ConnectionResolver results used
+
+    self._pause_condition = threading.Condition()
+    self._halt = False  # terminates thread if true
+
+    # Tracks exiting port and client country statistics
+
+    self._client_locale_usage = {}
+    self._exit_port_usage = {}
+    self._counted_connections = set()
+
+    # If we're a bridge and been running over a day then prepopulates with the
+    # last day's clients.
+
+    bridge_clients = tor_controller().get_info('status/clients-seen', None)
+
+    if bridge_clients:
+      # Response has a couple arguments...
+      # TimeStarted="2011-08-17 15:50:49" CountrySummary=us=16,de=8,uk=8
+
+      country_summary = None
+
+      for line in bridge_clients.split():
+        if line.startswith('CountrySummary='):
+          country_summary = line[15:]
+          break
+
+      if country_summary:
+        for entry in country_summary.split(','):
+          if re.match('^..=[0-9]+$', entry):
+            locale, count = entry.split('=', 1)
+            self._client_locale_usage[locale] = int(count)
+
+  def show_sort_dialog(self):
+    """
+    Provides a dialog for sorting our connections.
+    """
+
+    sort_colors = dict([(attr, CONFIG['attr.connection.sort_color'].get(attr, 'white')) for attr in SortAttr])
+    results = nyx.popups.show_sort_dialog('Connection Ordering:', SortAttr, self._sort_order, sort_colors)
+
+    if results:
+      self._sort_order = results
+      self._entries = sorted(self._entries, key = lambda entry: [entry.sort_value(attr) for attr in self._sort_order])
+
+  def handle_key(self, key):
+    user_traffic_allowed = tor_controller().is_user_traffic_allowed()
+
+    if key.is_scroll():
+      page_height = self.get_preferred_size()[0] - 1
+
+      if self._show_details:
+        page_height -= (DETAILS_HEIGHT + 1)
+
+      lines = list(itertools.chain.from_iterable([entry.get_lines() for entry in self._entries]))
+      is_changed = self._scroller.handle_key(key, lines, page_height)
+
+      if is_changed:
+        self.redraw(True)
+    elif key.is_selection():
+      self._show_details = not self._show_details
+      self.redraw(True)
+    elif key.match('s'):
+      self.show_sort_dialog()
+    elif key.match('r'):
+      connection_tracker = nyx.util.tracker.get_connection_tracker()
+      options = ['auto'] + list(connection.Resolver) + list(nyx.util.tracker.CustomResolver)
+
+      resolver = connection_tracker.get_custom_resolver()
+      selected_index = 0 if resolver is None else options.index(resolver)
+      selection = nyx.popups.show_menu('Connection Resolver:', options, selected_index)
+
+      if selection != -1:
+        connection_tracker.set_custom_resolver(None if selection == 0 else options[selection])
+    elif key.match('d'):
+      self.set_title_visible(False)
+      self.redraw(True)
+      entries = self._entries
+
+      while True:
+        lines = list(itertools.chain.from_iterable([entry.get_lines() for entry in entries]))
+        selection = self._scroller.get_cursor_selection(lines)
+
+        if not selection:
+          break
+
+        def is_close_key(key):
+          return key.is_selection() or key.match('d') or key.match('left') or key.match('right')
+
+        color = CONFIG['attr.connection.category_color'].get(selection.entry.get_type(), 'white')
+        key = nyx.popups.show_descriptor_popup(selection.fingerprint, color, self.max_x, is_close_key)
+
+        if not key or key.is_selection() or key.match('d'):
+          break  # closes popup
+        elif key.match('left'):
+          self.handle_key(panel.KeyInput(curses.KEY_UP))
+        elif key.match('right'):
+          self.handle_key(panel.KeyInput(curses.KEY_DOWN))
+
+      self.set_title_visible(True)
+      self.redraw(True)
+    elif key.match('c') and user_traffic_allowed.inbound:
+      nyx.popups.show_count_dialog('Client Locales', self._client_locale_usage)
+    elif key.match('e') and user_traffic_allowed.outbound:
+      counts = {}
+      key_width = max(map(len, self._exit_port_usage.keys()))
+
+      for k, v in self._exit_port_usage.items():
+        usage = connection.port_usage(k)
+
+        if usage:
+          k = k.ljust(key_width + 3) + usage.ljust(EXIT_USAGE_WIDTH)
+
+        counts[k] = v
+
+      nyx.popups.show_count_dialog('Exiting Port Usage', counts)
+    else:
+      return False
+
+    return True
+
+  def run(self):
+    """
+    Keeps connections listing updated, checking for new entries at a set rate.
+    """
+
+    last_ran = -1
+
+    while not self._halt:
+      if self.is_paused() or not tor_controller().is_alive() or (time.time() - last_ran) < UPDATE_RATE:
+        with self._pause_condition:
+          if not self._halt:
+            self._pause_condition.wait(0.2)
+
+        continue  # done waiting, try again
+
+      self._update()
+      self.redraw(True)
+
+      # If this is our first run then fill in our fingerprint tracker. This
+      # requires fetching all the router status entries which takes a few
+      # seconds, so best done when we're finished with the rest of the first
+      # iteration to hide the lag.
+
+      if last_ran == -1:
+        nyx.util.tracker.get_consensus_tracker().update(tor_controller().get_network_statuses([]))
+
+      last_ran = time.time()
+
+  def get_help(self):
+    resolver = nyx.util.tracker.get_connection_tracker().get_custom_resolver()
+    user_traffic_allowed = tor_controller().is_user_traffic_allowed()
+
+    options = [
+      ('up arrow', 'scroll up a line', None),
+      ('down arrow', 'scroll down a line', None),
+      ('page up', 'scroll up a page', None),
+      ('page down', 'scroll down a page', None),
+      ('enter', 'show connection details', None),
+      ('d', 'raw consensus descriptor', None),
+      ('s', 'sort ordering', None),
+      ('r', 'connection resolver', 'auto' if resolver is None else resolver),
+    ]
+
+    if user_traffic_allowed.inbound:
+      options.append(('c', 'client locale usage summary', None))
+
+    if user_traffic_allowed.outbound:
+      options.append(('e', 'exit port usage summary', None))
+
+    return options
+
+  def draw(self, width, height):
+    controller = tor_controller()
+    entries = self._entries
+
+    lines = list(itertools.chain.from_iterable([entry.get_lines() for entry in entries]))
+    selected = self._scroller.get_cursor_selection(lines)
+
+    if self.is_paused():
+      current_time = self.get_pause_time()
+    elif not controller.is_alive():
+      current_time = controller.connection_time()
+    else:
+      current_time = time.time()
+
+    is_showing_details = self._show_details and selected
+    details_offset = DETAILS_HEIGHT + 1 if is_showing_details else 0
+
+    is_scrollbar_visible = len(lines) > height - details_offset - 1
+    scroll_offset = 2 if is_scrollbar_visible else 0
+    scroll_location = self._scroller.get_scroll_location(lines, height - details_offset - 1)
+
+    if self.is_title_visible():
+      self._draw_title(entries, self._show_details)
+
+    if is_showing_details:
+      self._draw_details(selected, width, is_scrollbar_visible)
+
+    if is_scrollbar_visible:
+      self.add_scroll_bar(scroll_location, scroll_location + height - details_offset - 1, len(lines), 1 + details_offset)
+
+    for line_number in range(scroll_location, len(lines)):
+      y = line_number + details_offset + 1 - scroll_location
+      self._draw_line(scroll_offset, y, lines[line_number], lines[line_number] == selected, width - scroll_offset, current_time)
+
+      if y >= height:
+        break
+
+  def _draw_title(self, entries, showing_details):
+    """
+    Panel title with the number of connections we presently have.
+    """
+
+    if showing_details:
+      self.addstr(0, 0, 'Connection Details:', curses.A_STANDOUT)
+    elif not entries:
+      self.addstr(0, 0, 'Connections:', curses.A_STANDOUT)
+    else:
+      counts = collections.Counter([entry.get_type() for entry in entries])
+      count_labels = ['%i %s' % (counts[category], category.lower()) for category in Category if counts[category]]
+      self.addstr(0, 0, 'Connections (%s):' % ', '.join(count_labels), curses.A_STANDOUT)
+
+  def _draw_details(self, selected, width, is_scrollbar_visible):
+    """
+    Shows detailed information about the selected connection.
+    """
+
+    attr = (CONFIG['attr.connection.category_color'].get(selected.entry.get_type(), 'white'), curses.A_BOLD)
+
+    if selected.line_type == LineType.CIRCUIT_HEADER and selected.circuit.status != 'BUILT':
+      self.addstr(1, 2, 'Building Circuit...', *attr)
+    else:
+      address = '<scrubbed>' if selected.entry.is_private() else selected.connection.remote_address
+      self.addstr(1, 2, 'address: %s:%s' % (address, selected.connection.remote_port), *attr)
+      self.addstr(2, 2, 'locale: %s' % ('??' if selected.entry.is_private() else (selected.locale if selected.locale else '??')), *attr)
+
+      matches = nyx.util.tracker.get_consensus_tracker().get_relay_fingerprints(selected.connection.remote_address)
+
+      if not matches:
+        self.addstr(3, 2, 'No consensus data found', *attr)
+      elif len(matches) == 1 or selected.connection.remote_port in matches:
+        controller = tor_controller()
+        fingerprint = matches.values()[0] if len(matches) == 1 else matches[selected.connection.remote_port]
+        router_status_entry = controller.get_network_status(fingerprint, None)
+
+        self.addstr(2, 15, 'fingerprint: %s' % fingerprint, *attr)
+
+        if router_status_entry:
+          dir_port_label = 'dirport: %s' % router_status_entry.dir_port if router_status_entry.dir_port else ''
+          self.addstr(3, 2, 'nickname: %-25s orport: %-10s %s' % (router_status_entry.nickname, router_status_entry.or_port, dir_port_label), *attr)
+          self.addstr(4, 2, 'published: %s' % router_status_entry.published.strftime("%H:%M %m/%d/%Y"), *attr)
+          self.addstr(5, 2, 'flags: %s' % ', '.join(router_status_entry.flags), *attr)
+
+          server_descriptor = controller.get_server_descriptor(fingerprint, None)
+
+          if server_descriptor:
+            policy_label = server_descriptor.exit_policy.summary() if server_descriptor.exit_policy else 'unknown'
+            self.addstr(6, 2, 'exit policy: %s' % policy_label, *attr)
+            self.addstr(4, 38, 'os: %-14s version: %s' % (server_descriptor.operating_system, server_descriptor.tor_version), *attr)
+
+            if server_descriptor.contact:
+              self.addstr(7, 2, 'contact: %s' % server_descriptor.contact, *attr)
+      else:
+        self.addstr(3, 2, 'Multiple matches, possible fingerprints are:', *attr)
+
+        for i, port in enumerate(sorted(matches.keys())):
+          is_last_line, remaining_relays = i == 3, len(matches) - i
+
+          if not is_last_line or remaining_relays == 1:
+            self.addstr(4 + i, 2, '%i. or port: %-5s fingerprint: %s' % (i + 1, port, matches[port]), *attr)
+          else:
+            self.addstr(4 + i, 2, '... %i more' % remaining_relays, *attr)
+
+          if is_last_line:
+            break
+
+    # draw the border, with a 'T' pipe if connecting with the scrollbar
+
+    ui_tools.draw_box(self, 0, 0, width, DETAILS_HEIGHT + 2)
+
+    if is_scrollbar_visible:
+      self.addch(DETAILS_HEIGHT + 1, 1, curses.ACS_TTEE)
+
+  def _draw_line(self, x, y, line, is_selected, width, current_time):
+    attr = nyx.util.ui_tools.get_color(CONFIG['attr.connection.category_color'].get(line.entry.get_type(), 'white'))
+    attr |= curses.A_STANDOUT if is_selected else curses.A_NORMAL
+
+    self.addstr(y, x, ' ' * (width - x), attr)
+
+    if line.line_type == LineType.CIRCUIT:
+      if line.circuit.path[-1][0] == line.fingerprint:
+        prefix = (ord(' '), curses.ACS_LLCORNER, curses.ACS_HLINE, ord(' '))
+      else:
+        prefix = (ord(' '), curses.ACS_VLINE, ord(' '), ord(' '))
+
+      for char in prefix:
+        x = self.addch(y, x, char)
+    else:
+      x += 1  # offset from edge
+
+    self._draw_address_column(x, y, line, attr)
+    self._draw_line_details(57, y, line, width - 57 - 20, attr)
+    self._draw_right_column(width - 18, y, line, current_time, attr)
+
+  def _draw_address_column(self, x, y, line, attr):
+    src = tor_controller().get_info('address', line.connection.local_address)
+    src += ':%s' % line.connection.local_port if line.line_type == LineType.CONNECTION else ''
+
+    if line.line_type == LineType.CIRCUIT_HEADER and line.circuit.status != 'BUILT':
+      dst = 'Building...'
+    else:
+      dst = '<scrubbed>' if line.entry.is_private() else line.connection.remote_address
+      dst += ':%s' % line.connection.remote_port
+
+      if line.entry.get_type() == Category.EXIT:
+        purpose = connection.port_usage(line.connection.remote_port)
+
+        if purpose:
+          dst += ' (%s)' % str_tools.crop(purpose, 26 - len(dst) - 3)
+      elif not tor_controller().is_geoip_unavailable() and not line.entry.is_private():
+        dst += ' (%s)' % (line.locale if line.locale else '??')
+
+    if line.entry.get_type() in (Category.INBOUND, Category.SOCKS, Category.CONTROL):
+      dst, src = src, dst
+
+    if line.line_type == LineType.CIRCUIT:
+      self.addstr(y, x, dst, attr)
+    else:
+      self.addstr(y, x, '%-21s  -->  %-26s' % (src, dst), attr)
+
+  def _draw_line_details(self, x, y, line, width, attr):
+    if line.line_type == LineType.CIRCUIT_HEADER:
+      comp = ['Purpose: %s' % line.circuit.purpose.capitalize(), ', Circuit ID: %s' % line.circuit.id]
+    elif line.entry.get_type() in (Category.SOCKS, Category.HIDDEN, Category.CONTROL):
+      try:
+        port = line.connection.local_port if line.entry.get_type() == Category.HIDDEN else line.connection.remote_port
+        process = nyx.util.tracker.get_port_usage_tracker().fetch(port)
+        comp = ['%s (%s)' % (process.name, process.pid) if process.pid else process.name]
+      except nyx.util.tracker.UnresolvedResult:
+        comp = ['resolving...']
+      except nyx.util.tracker.UnknownApplication:
+        comp = ['UNKNOWN']
+    else:
+      comp = ['%-40s' % (line.fingerprint if line.fingerprint else 'UNKNOWN'), '  ' + (line.nickname if line.nickname else 'UNKNOWN')]
+
+    for entry in comp:
+      if width >= x + len(entry):
+        x = self.addstr(y, x, entry, attr)
+      else:
+        return
+
+  def _draw_right_column(self, x, y, line, current_time, attr):
+    if line.line_type == LineType.CIRCUIT:
+      circ_path = [fp for fp, _ in line.circuit.path]
+      circ_index = circ_path.index(line.fingerprint)
+
+      if circ_index == len(circ_path) - 1:
+        placement_type = 'Exit' if line.circuit.status == 'BUILT' else 'Extending'
+      elif circ_index == 0:
+        placement_type = 'Guard'
+      else:
+        placement_type = 'Middle'
+
+      self.addstr(y, x + 4, '%i / %s' % (circ_index + 1, placement_type), attr)
+    else:
+      x = self.addstr(y, x, '+' if line.connection.is_legacy else ' ', attr)
+      x = self.addstr(y, x, '%5s' % str_tools.time_label(current_time - line.connection.start_time, 1), attr)
+      x = self.addstr(y, x, ' (', attr)
+      x = self.addstr(y, x, line.entry.get_type().upper(), attr | curses.A_BOLD)
+      x = self.addstr(y, x, ')', attr)
+
+  def stop(self):
+    """
+    Halts further resolutions and terminates the thread.
+    """
+
+    with self._pause_condition:
+      self._halt = True
+      self._pause_condition.notifyAll()
+
+  def _update(self):
+    """
+    Fetches the newest resolved connections.
+    """
+
+    global LAST_RETRIEVED_CIRCUITS, LAST_RETRIEVED_HS_CONF
+
+    controller = tor_controller()
+    LAST_RETRIEVED_CIRCUITS = controller.get_circuits([])
+    LAST_RETRIEVED_HS_CONF = controller.get_hidden_service_conf({})
+
+    conn_resolver = nyx.util.tracker.get_connection_tracker()
+    current_resolution_count = conn_resolver.run_counter()
+
+    if not conn_resolver.is_alive():
+      return  # if we're not fetching connections then this is a no-op
+    elif current_resolution_count == self._last_resource_fetch:
+      return  # no new connections to process
+
+    new_entries = [Entry.from_connection(conn) for conn in conn_resolver.get_value()]
+
+    for circ in LAST_RETRIEVED_CIRCUITS:
+      # Skips established single-hop circuits (these are for directory
+      # fetches, not client circuits)
+
+      if not (circ.status == 'BUILT' and len(circ.path) == 1):
+        new_entries.append(Entry.from_circuit(circ))
+
+    # update stats for client and exit connections
+
+    for entry in new_entries:
+      line = entry.get_lines()[0]
+
+      if entry.is_private() and line.connection not in self._counted_connections:
+        if entry.get_type() == Category.INBOUND and line.locale:
+          self._client_locale_usage[line.locale] = self._client_locale_usage.get(line.locale, 0) + 1
+        elif entry.get_type() == Category.EXIT:
+          self._exit_port_usage[line.connection.remote_port] = self._exit_port_usage.get(line.connection.remote_port, 0) + 1
+
+        self._counted_connections.add(line.connection)
+
+    self._entries = sorted(new_entries, key = lambda entry: [entry.sort_value(attr) for attr in self._sort_order])
+    self._last_resource_fetch = current_resolution_count
+
+    if CONFIG['features.connection.resolveApps']:
+      local_ports, remote_ports = [], []
+
+      for entry in new_entries:
+        line = entry.get_lines()[0]
+
+        if entry.get_type() in (Category.SOCKS, Category.CONTROL):
+          local_ports.append(line.connection.remote_port)
+        elif entry.get_type() == Category.HIDDEN:
+          remote_ports.append(line.connection.local_port)
+
+      nyx.util.tracker.get_port_usage_tracker().query(local_ports, remote_ports)
diff --git a/nyx/panel/graph.py b/nyx/panel/graph.py
new file mode 100644
index 0000000..086d04d
--- /dev/null
+++ b/nyx/panel/graph.py
@@ -0,0 +1,753 @@
+"""
+Graphs of tor related statistics. For example...
+
+Downloaded (0.0 B/sec):           Uploaded (0.0 B/sec):
+  34                                30
+                            *                                 *
+                    **  *   *                          *      **
+      *   *  *      ** **   **          ***  **       ** **   **
+     *********      ******  ******     *********      ******  ******
+   0 ************ ****************   0 ************ ****************
+         25s  50   1m   1.6  2.0           25s  50   1m   1.6  2.0
+"""
+
+import collections
+import copy
+import curses
+import time
+
+import nyx.controller
+import nyx.popups
+import nyx.util.tracker
+
+from stem.control import EventType, Listener
+from stem.util import conf, enum, log, str_tools, system
+from nyx.util import join, msg, panel, tor_controller
+
+GraphStat = enum.Enum(('BANDWIDTH', 'bandwidth'), ('CONNECTIONS', 'connections'), ('SYSTEM_RESOURCES', 'resources'))
+Interval = enum.Enum(('EACH_SECOND', 'each second'), ('FIVE_SECONDS', '5 seconds'), ('THIRTY_SECONDS', '30 seconds'), ('MINUTELY', 'minutely'), ('FIFTEEN_MINUTE', '15 minute'), ('THIRTY_MINUTE', '30 minute'), ('HOURLY', 'hourly'), ('DAILY', 'daily'))
+Bounds = enum.Enum(('GLOBAL_MAX', 'global_max'), ('LOCAL_MAX', 'local_max'), ('TIGHT', 'tight'))
+
+DrawAttributes = collections.namedtuple('DrawAttributes', ('stat', 'subgraph_height', 'subgraph_width', 'interval', 'bounds_type', 'accounting'))
+
+INTERVAL_SECONDS = {
+  Interval.EACH_SECOND: 1,
+  Interval.FIVE_SECONDS: 5,
+  Interval.THIRTY_SECONDS: 30,
+  Interval.MINUTELY: 60,
+  Interval.FIFTEEN_MINUTE: 900,
+  Interval.THIRTY_MINUTE: 1800,
+  Interval.HOURLY: 3600,
+  Interval.DAILY: 86400,
+}
+
+PRIMARY_COLOR, SECONDARY_COLOR = 'green', 'cyan'
+
+ACCOUNTING_RATE = 5
+DEFAULT_CONTENT_HEIGHT = 4  # space needed for labeling above and below the graph
+WIDE_LABELING_GRAPH_COL = 50  # minimum graph columns to use wide spacing for x-axis labels
+COLLAPSE_WIDTH = 135  # width at which to move optional stats from the title to x-axis label
+
+
+def conf_handler(key, value):
+  if key == 'features.graph.height':
+    return max(1, value)
+  elif key == 'features.graph.max_width':
+    return max(1, value)
+  elif key == 'features.graph.type':
+    if value != 'none' and value not in GraphStat:
+      log.warn("'%s' isn't a valid graph type, options are: none, %s" % (CONFIG['features.graph.type'], ', '.join(GraphStat)))
+      return CONFIG['features.graph.type']  # keep the default
+  elif key == 'features.graph.interval':
+    if value not in Interval:
+      log.warn("'%s' isn't a valid graphing interval, options are: %s" % (value, ', '.join(Interval)))
+      return CONFIG['features.graph.interval']  # keep the default
+  elif key == 'features.graph.bound':
+    if value not in Bounds:
+      log.warn("'%s' isn't a valid graph bounds, options are: %s" % (value, ', '.join(Bounds)))
+      return CONFIG['features.graph.bound']  # keep the default
+
+
+CONFIG = conf.config_dict('nyx', {
+  'attr.hibernate_color': {},
+  'attr.graph.title': {},
+  'attr.graph.header.primary': {},
+  'attr.graph.header.secondary': {},
+  'features.graph.height': 7,
+  'features.graph.type': GraphStat.BANDWIDTH,
+  'features.graph.interval': Interval.EACH_SECOND,
+  'features.graph.bound': Bounds.LOCAL_MAX,
+  'features.graph.max_width': 300,  # we need some sort of max size so we know how much graph data to retain
+  'features.panels.show.connection': True,
+  'features.graph.bw.transferInBytes': False,
+  'features.graph.bw.accounting.show': True,
+}, conf_handler)
+
+
+class GraphData(object):
+  """
+  Graphable statistical information.
+
+  :var int latest_value: last value we recorded
+  :var int total: sum of all values we've recorded
+  :var int tick: number of events we've processed
+  :var dict values: mapping of intervals to an array of samplings from newest to oldest
+  :var dict max_value: mapping of intervals to the maximum value it has had
+  """
+
+  def __init__(self, clone = None, category = None, is_primary = True):
+    if clone:
+      self.latest_value = clone.latest_value
+      self.total = clone.total
+      self.tick = clone.tick
+      self.values = copy.deepcopy(clone.values)
+      self.max_value = dict(clone.max_value)
+
+      self._category = clone._category
+      self._is_primary = clone._is_primary
+      self._in_process_value = dict(clone._in_process_value)
+    else:
+      self.latest_value = 0
+      self.total = 0
+      self.tick = 0
+      self.values = dict([(i, CONFIG['features.graph.max_width'] * [0]) for i in Interval])
+      self.max_value = dict([(i, 0) for i in Interval])
+
+      self._category = category
+      self._is_primary = is_primary
+      self._in_process_value = dict([(i, 0) for i in Interval])
+
+  def average(self):
+    return self.total / max(1, self.tick)
+
+  def update(self, new_value):
+    self.latest_value = new_value
+    self.total += new_value
+    self.tick += 1
+
+    for interval in Interval:
+      interval_seconds = INTERVAL_SECONDS[interval]
+      self._in_process_value[interval] += new_value
+
+      if self.tick % interval_seconds == 0:
+        new_entry = self._in_process_value[interval] / interval_seconds
+        self.values[interval] = [new_entry] + self.values[interval][:-1]
+        self.max_value[interval] = max(self.max_value[interval], new_entry)
+        self._in_process_value[interval] = 0
+
+  def header(self, width):
+    """
+    Provides the description above a subgraph.
+
+    :param int width: maximum length of the header
+
+    :returns: **str** with our graph header
+    """
+
+    return self._category._header(width, self._is_primary)
+
+  def y_axis_label(self, value):
+    """
+    Provides the label we should display on our y-axis.
+
+    :param int value: value being shown on the y-axis
+
+    :returns: **str** with our y-axis label
+    """
+
+    return self._category._y_axis_label(value, self._is_primary)
+
+
+class GraphCategory(object):
+  """
+  Category for the graph. This maintains two subgraphs, updating them each
+  second with updated stats.
+
+  :var GraphData primary: first subgraph
+  :var GraphData secondary: second subgraph
+  :var float start_time: unix timestamp for when we started
+  """
+
+  def __init__(self, clone = None):
+    if clone:
+      self.primary = GraphData(clone.primary)
+      self.secondary = GraphData(clone.secondary)
+      self.start_time = clone.start_time
+      self._title_stats = list(clone._title_stats)
+      self._primary_header_stats = list(clone._primary_header_stats)
+      self._secondary_header_stats = list(clone._secondary_header_stats)
+    else:
+      self.primary = GraphData(category = self, is_primary = True)
+      self.secondary = GraphData(category = self, is_primary = False)
+      self.start_time = time.time()
+      self._title_stats = []
+      self._primary_header_stats = []
+      self._secondary_header_stats = []
+
+  def stat_type(self):
+    """
+    Provides the GraphStat this graph is for.
+
+    :returns: **GraphStat** of this graph
+    """
+
+    raise NotImplementedError('Should be implemented by subclasses')
+
+  def title(self, width):
+    """
+    Provides a graph title that fits in the given width.
+
+    :param int width: maximum length of the title
+
+    :returns: **str** with our title
+    """
+
+    title = CONFIG['attr.graph.title'].get(self.stat_type(), '')
+    title_stats = join(self._title_stats, ', ', width - len(title) - 4)
+    return '%s (%s):' % (title, title_stats) if title_stats else title + ':'
+
+  def bandwidth_event(self, event):
+    """
+    Called when it's time to process another event. All graphs use tor BW
+    events to keep in sync with each other (this happens once per second).
+    """
+
+    pass
+
+  def _header(self, is_primary, width):
+    if is_primary:
+      header = CONFIG['attr.graph.header.primary'].get(self.stat_type(), '')
+      header_stats = self._primary_header_stats
+    else:
+      header = CONFIG['attr.graph.header.secondary'].get(self.stat_type(), '')
+      header_stats = self._secondary_header_stats
+
+    header_stats = join(header_stats, '', width - len(header) - 4)
+    return '%s (%s):' % (header, header_stats) if header_stats else '%s:' % header
+
+  def _y_axis_label(self, value, is_primary):
+    return str(value)
+
+
+class BandwidthStats(GraphCategory):
+  """
+  Tracks tor's bandwidth usage.
+  """
+
+  def __init__(self, clone = None):
+    GraphCategory.__init__(self, clone)
+
+    if not clone:
+      # fill in past bandwidth information
+
+      controller = tor_controller()
+      bw_entries, is_successful = controller.get_info('bw-event-cache', None), True
+
+      if bw_entries:
+        for entry in bw_entries.split():
+          entry_comp = entry.split(',')
+
+          if len(entry_comp) != 2 or not entry_comp[0].isdigit() or not entry_comp[1].isdigit():
+            log.warn(msg('panel.graphing.bw_event_cache_malformed', response = bw_entries))
+            is_successful = False
+            break
+
+          self.primary.update(int(entry_comp[0]))
+          self.secondary.update(int(entry_comp[1]))
+
+        if is_successful:
+          log.info(msg('panel.graphing.prepopulation_successful', duration = str_tools.time_label(len(bw_entries.split()), is_long = True)))
+
+      read_total = controller.get_info('traffic/read', None)
+      write_total = controller.get_info('traffic/written', None)
+      start_time = system.start_time(controller.get_pid(None))
+
+      if read_total and write_total and start_time:
+        self.primary.total = int(read_total)
+        self.secondary.total = int(write_total)
+        self.start_time = start_time
+
+  def stat_type(self):
+    return GraphStat.BANDWIDTH
+
+  def _y_axis_label(self, value, is_primary):
+    return _size_label(value, 0)
+
+  def bandwidth_event(self, event):
+    self.primary.update(event.read)
+    self.secondary.update(event.written)
+
+    self._primary_header_stats = [
+      '%-14s' % ('%s/sec' % _size_label(self.primary.latest_value)),
+      '- avg: %s/sec' % _size_label(self.primary.total / (time.time() - self.start_time)),
+      ', total: %s' % _size_label(self.primary.total),
+    ]
+
+    self._secondary_header_stats = [
+      '%-14s' % ('%s/sec' % _size_label(self.secondary.latest_value)),
+      '- avg: %s/sec' % _size_label(self.secondary.total / (time.time() - self.start_time)),
+      ', total: %s' % _size_label(self.secondary.total),
+    ]
+
+    controller = tor_controller()
+
+    stats = []
+    bw_rate = controller.get_effective_rate(None)
+    bw_burst = controller.get_effective_rate(None, burst = True)
+
+    if bw_rate and bw_burst:
+      bw_rate_label = _size_label(bw_rate)
+      bw_burst_label = _size_label(bw_burst)
+
+      # if both are using rounded values then strip off the '.0' decimal
+
+      if '.0' in bw_rate_label and '.0' in bw_burst_label:
+        bw_rate_label = bw_rate_label.split('.', 1)[0]
+        bw_burst_label = bw_burst_label.split('.', 1)[0]
+
+      stats.append('limit: %s/s' % bw_rate_label)
+      stats.append('burst: %s/s' % bw_burst_label)
+
+    my_router_status_entry = controller.get_network_status(default = None)
+    measured_bw = getattr(my_router_status_entry, 'bandwidth', None)
+
+    if measured_bw:
+      stats.append('measured: %s/s' % _size_label(measured_bw))
+    else:
+      my_server_descriptor = controller.get_server_descriptor(default = None)
+      observed_bw = getattr(my_server_descriptor, 'observed_bandwidth', None)
+
+      if observed_bw:
+        stats.append('observed: %s/s' % _size_label(observed_bw))
+
+    self._title_stats = stats
+
+
+class ConnectionStats(GraphCategory):
+  """
+  Tracks number of inbound and outbound connections.
+  """
+
+  def stat_type(self):
+    return GraphStat.CONNECTIONS
+
+  def bandwidth_event(self, event):
+    inbound_count, outbound_count = 0, 0
+
+    controller = tor_controller()
+    or_ports = controller.get_ports(Listener.OR, [])
+    dir_ports = controller.get_ports(Listener.DIR, [])
+    control_ports = controller.get_ports(Listener.CONTROL, [])
+
+    for entry in nyx.util.tracker.get_connection_tracker().get_value():
+      if entry.local_port in or_ports or entry.local_port in dir_ports:
+        inbound_count += 1
+      elif entry.local_port in control_ports:
+        pass  # control connection
+      else:
+        outbound_count += 1
+
+    self.primary.update(inbound_count)
+    self.secondary.update(outbound_count)
+
+    self._primary_header_stats = [str(self.primary.latest_value), ', avg: %s' % self.primary.average()]
+    self._secondary_header_stats = [str(self.secondary.latest_value), ', avg: %s' % self.secondary.average()]
+
+
+class ResourceStats(GraphCategory):
+  """
+  Tracks cpu and memory usage of the tor process.
+  """
+
+  def stat_type(self):
+    return GraphStat.SYSTEM_RESOURCES
+
+  def _y_axis_label(self, value, is_primary):
+    return '%i%%' % value if is_primary else str_tools.size_label(value)
+
+  def bandwidth_event(self, event):
+    resources = nyx.util.tracker.get_resource_tracker().get_value()
+    self.primary.update(resources.cpu_sample * 100)  # decimal percentage to whole numbers
+    self.secondary.update(resources.memory_bytes)
+
+    self._primary_header_stats = ['%0.1f%%' % self.primary.latest_value, ', avg: %0.1f%%' % self.primary.average()]
+    self._secondary_header_stats = [str_tools.size_label(self.secondary.latest_value, 1), ', avg: %s' % str_tools.size_label(self.secondary.average(), 1)]
+
+
+class GraphPanel(panel.Panel):
+  """
+  Panel displaying graphical information of GraphCategory instances.
+  """
+
+  def __init__(self, stdscr):
+    panel.Panel.__init__(self, stdscr, 'graph', 0)
+
+    self._displayed_stat = None if CONFIG['features.graph.type'] == 'none' else CONFIG['features.graph.type']
+    self._update_interval = CONFIG['features.graph.interval']
+    self._bounds = CONFIG['features.graph.bound']
+    self._graph_height = CONFIG['features.graph.height']
+
+    self._accounting_stats = None
+
+    self._stats = {
+      GraphStat.BANDWIDTH: BandwidthStats(),
+      GraphStat.SYSTEM_RESOURCES: ResourceStats(),
+    }
+
+    if CONFIG['features.panels.show.connection']:
+      self._stats[GraphStat.CONNECTIONS] = ConnectionStats()
+    elif self._displayed_stat == GraphStat.CONNECTIONS:
+      log.warn("The connection graph is unavailble when you set 'features.panels.show.connection false'.")
+      self._displayed_stat = GraphStat.BANDWIDTH
+
+    self.set_pause_attr('_stats')
+    self.set_pause_attr('_accounting_stats')
+
+    controller = tor_controller()
+    controller.add_event_listener(self._update_accounting, EventType.BW)
+    controller.add_event_listener(self._update_stats, EventType.BW)
+    controller.add_status_listener(lambda *args: self.redraw(True))
+
+  @property
+  def displayed_stat(self):
+    return self._displayed_stat
+
+  @displayed_stat.setter
+  def displayed_stat(self, value):
+    if value is not None and value not in self._stats.keys():
+      raise ValueError("%s isn't a graphed statistic" % value)
+
+    self._displayed_stat = value
+
+  def stat_options(self):
+    return self._stats.keys()
+
+  @property
+  def update_interval(self):
+    return self._update_interval
+
+  @update_interval.setter
+  def update_interval(self, value):
+    if value not in Interval:
+      raise ValueError("%s isn't a valid graphing update interval" % value)
+
+    self._update_interval = value
+
+  @property
+  def bounds_type(self):
+    return self._bounds
+
+  @bounds_type.setter
+  def bounds_type(self, value):
+    if value not in Bounds:
+      raise ValueError("%s isn't a valid type of bounds" % value)
+
+    self._bounds = value
+
+  def get_height(self):
+    """
+    Provides the height of the content.
+    """
+
+    if not self.displayed_stat:
+      return 0
+
+    height = DEFAULT_CONTENT_HEIGHT + self._graph_height
+
+    if self.displayed_stat == GraphStat.BANDWIDTH and self._accounting_stats:
+      height += 3
+
+    return height
+
+  def set_graph_height(self, new_graph_height):
+    self._graph_height = max(1, new_graph_height)
+
+  def resize_graph(self):
+    """
+    Prompts for user input to resize the graph panel. Options include...
+
+      * down arrow - grow graph
+      * up arrow - shrink graph
+      * enter / space - set size
+    """
+
+    control = nyx.controller.get_controller()
+
+    with panel.CURSES_LOCK:
+      try:
+        while True:
+          msg = 'press the down/up to resize the graph, and enter when done'
+          control.set_msg(msg, curses.A_BOLD, True)
+          curses.cbreak()
+          key = control.key_input()
+
+          if key.match('down'):
+            # don't grow the graph if it's already consuming the whole display
+            # (plus an extra line for the graph/log gap)
+
+            max_height = self.parent.getmaxyx()[0] - self.top
+            current_height = self.get_height()
+
+            if current_height < max_height + 1:
+              self.set_graph_height(self._graph_height + 1)
+          elif key.match('up'):
+            self.set_graph_height(self._graph_height - 1)
+          elif key.is_selection():
+            break
+
+          control.redraw()
+      finally:
+        control.set_msg()
+
+  def handle_key(self, key):
+    if key.match('r'):
+      self.resize_graph()
+    elif key.match('b'):
+      # uses the next boundary type
+      self.bounds_type = Bounds.next(self.bounds_type)
+      self.redraw(True)
+    elif key.match('s'):
+      # provides a menu to pick the graphed stats
+
+      available_stats = sorted(self.stat_options())
+      options = ['None'] + [stat.capitalize() for stat in available_stats]
+      initial_selection = available_stats.index(self.displayed_stat) + 1 if self.displayed_stat else 0
+
+      selection = nyx.popups.show_menu('Graphed Stats:', options, initial_selection)
+
+      # applies new setting
+
+      if selection == 0:
+        self.displayed_stat = None
+      elif selection != -1:
+        self.displayed_stat = available_stats[selection - 1]
+    elif key.match('i'):
+      # provides menu to pick graph panel update interval
+
+      selection = nyx.popups.show_menu('Update Interval:', list(Interval), list(Interval).index(self.update_interval))
+
+      if selection != -1:
+        self.update_interval = list(Interval)[selection]
+    else:
+      return False
+
+    return True
+
+  def get_help(self):
+    return [
+      ('r', 'resize graph', None),
+      ('s', 'graphed stats', self.displayed_stat if self.displayed_stat else 'none'),
+      ('b', 'graph bounds', self.bounds_type.replace('_', ' ')),
+      ('i', 'graph update interval', self.update_interval),
+    ]
+
+  def draw(self, width, height):
+    if not self.displayed_stat:
+      return
+
+    stat = self.get_attr('_stats')[self.displayed_stat]
+
+    attr = DrawAttributes(
+      stat = type(stat)(stat),  # clone the GraphCategory
+      subgraph_height = self._graph_height + 2,  # graph rows + header + x-axis label
+      subgraph_width = min(width / 2, CONFIG['features.graph.max_width']),
+      interval = self.update_interval,
+      bounds_type = self.bounds_type,
+      accounting = self.get_attr('_accounting_stats'),
+    )
+
+    if self.is_title_visible():
+      self.addstr(0, 0, attr.stat.title(width), curses.A_STANDOUT)
+
+    self._draw_subgraph(attr, attr.stat.primary, 0, PRIMARY_COLOR)
+    self._draw_subgraph(attr, attr.stat.secondary, attr.subgraph_width, SECONDARY_COLOR)
+
+    if attr.stat.stat_type() == GraphStat.BANDWIDTH:
+      if width <= COLLAPSE_WIDTH:
+        self._draw_bandwidth_stats(attr, width)
+
+      if attr.accounting:
+        self._draw_accounting_stats(attr)
+
+  def _draw_subgraph(self, attr, data, x, color):
+    # Concering our subgraph colums, the y-axis label can be at most six
+    # characters, with two spaces of padding on either side of the graph.
+    # Starting with the smallest size, then possibly raise it after determing
+    # the y_axis_labels.
+
+    subgraph_columns = attr.subgraph_width - 8
+    min_bound, max_bound = self._get_graph_bounds(attr, data, subgraph_columns)
+
+    x_axis_labels = self._get_x_axis_labels(attr, subgraph_columns)
+    y_axis_labels = self._get_y_axis_labels(attr, data, min_bound, max_bound)
+    subgraph_columns = max(subgraph_columns, attr.subgraph_width - max([len(label) for label in y_axis_labels.values()]) - 2)
+    axis_offset = max([len(label) for label in y_axis_labels.values()])
+
+    self.addstr(1, x, data.header(attr.subgraph_width), curses.A_BOLD, color)
+
+    for x_offset, label in x_axis_labels.items():
+      self.addstr(attr.subgraph_height, x + x_offset + axis_offset, label, color)
+
+    for y, label in y_axis_labels.items():
+      self.addstr(y, x, label, color)
+
+    for col in range(subgraph_columns):
+      column_count = int(data.values[attr.interval][col]) - min_bound
+      column_height = int(min(attr.subgraph_height - 2, (attr.subgraph_height - 2) * column_count / (max(1, max_bound) - min_bound)))
+
+      for row in range(column_height):
+        self.addstr(attr.subgraph_height - 1 - row, x + col + axis_offset + 1, ' ', curses.A_STANDOUT, color)
+
+  def _get_graph_bounds(self, attr, data, subgraph_columns):
+    """
+    Provides the range the graph shows (ie, its minimum and maximum value).
+    """
+
+    min_bound, max_bound = 0, 0
+    values = data.values[attr.interval][:subgraph_columns]
+
+    if attr.bounds_type == Bounds.GLOBAL_MAX:
+      max_bound = data.max_value[attr.interval]
+    elif subgraph_columns > 0:
+      max_bound = max(values)  # local maxima
+
+    if attr.bounds_type == Bounds.TIGHT and subgraph_columns > 0:
+      min_bound = min(values)
+
+      # if the max = min pick zero so we still display something
+
+      if min_bound == max_bound:
+        min_bound = 0
+
+    return min_bound, max_bound
+
+  def _get_y_axis_labels(self, attr, data, min_bound, max_bound):
+    """
+    Provides the labels for the y-axis. This is a mapping of the position it
+    should be drawn at to its text.
+    """
+
+    y_axis_labels = {
+      2: data.y_axis_label(max_bound),
+      attr.subgraph_height - 1: data.y_axis_label(min_bound),
+    }
+
+    ticks = (attr.subgraph_height - 5) / 2
+
+    for i in range(ticks):
+      row = attr.subgraph_height - (2 * i) - 5
+
+      if attr.subgraph_height % 2 == 0 and i >= (ticks / 2):
+        row -= 1  # make extra gap be in the middle when we're an even size
+
+      val = (max_bound - min_bound) * (attr.subgraph_height - row - 3) / (attr.subgraph_height - 3)
+
+      if val not in (min_bound, max_bound):
+        y_axis_labels[row + 2] = data.y_axis_label(val)
+
+    return y_axis_labels
+
+  def _get_x_axis_labels(self, attr, subgraph_columns):
+    """
+    Provides the labels for the x-axis. We include the units for only its first
+    value, then bump the precision for subsequent units. For example...
+
+      10s, 20, 30, 40, 50, 1m, 1.1, 1.3, 1.5
+    """
+
+    x_axis_labels = {}
+
+    interval_sec = INTERVAL_SECONDS[attr.interval]
+    interval_spacing = 10 if subgraph_columns >= WIDE_LABELING_GRAPH_COL else 5
+    units_label, decimal_precision = None, 0
+
+    for i in range((subgraph_columns - 4) / interval_spacing):
+      x = (i + 1) * interval_spacing
+      time_label = str_tools.time_label(x * interval_sec, decimal_precision)
+
+      if not units_label:
+        units_label = time_label[-1]
+      elif units_label != time_label[-1]:
+        # upped scale so also up precision of future measurements
+        units_label = time_label[-1]
+        decimal_precision += 1
+      else:
+        # if constrained on space then strips labeling since already provided
+        time_label = time_label[:-1]
+
+      x_axis_labels[x] = time_label
+
+    return x_axis_labels
+
+  def _draw_bandwidth_stats(self, attr, width):
+    """
+    Replaces the x-axis labeling with bandwidth stats. This is done on small
+    screens since this information otherwise wouldn't fit.
+    """
+
+    labeling_line = DEFAULT_CONTENT_HEIGHT + attr.subgraph_height - 4
+    self.addstr(labeling_line, 0, ' ' * width)  # clear line
+
+    runtime = time.time() - attr.stat.start_time
+    primary_footer = 'total: %s, avg: %s/sec' % (_size_label(attr.stat.primary.total), _size_label(attr.stat.primary.total / runtime))
+    secondary_footer = 'total: %s, avg: %s/sec' % (_size_label(attr.stat.secondary.total), _size_label(attr.stat.secondary.total / runtime))
+
+    self.addstr(labeling_line, 1, primary_footer, PRIMARY_COLOR)
+    self.addstr(labeling_line, attr.subgraph_width + 1, secondary_footer, SECONDARY_COLOR)
+
+  def _draw_accounting_stats(self, attr):
+    y = DEFAULT_CONTENT_HEIGHT + attr.subgraph_height - 2
+
+    if tor_controller().is_alive():
+      hibernate_color = CONFIG['attr.hibernate_color'].get(attr.accounting.status, 'red')
+
+      x = self.addstr(y, 0, 'Accounting (', curses.A_BOLD)
+      x = self.addstr(y, x, attr.accounting.status, curses.A_BOLD, hibernate_color)
+      x = self.addstr(y, x, ')', curses.A_BOLD)
+
+      self.addstr(y, 35, 'Time to reset: %s' % str_tools.short_time_label(attr.accounting.time_until_reset))
+
+      self.addstr(y + 1, 2, '%s / %s' % (attr.accounting.read_bytes, attr.accounting.read_limit), PRIMARY_COLOR)
+      self.addstr(y + 1, 37, '%s / %s' % (attr.accounting.written_bytes, attr.accounting.write_limit), SECONDARY_COLOR)
+    else:
+      self.addstr(y, 0, 'Accounting:', curses.A_BOLD)
+      self.addstr(y, 12, 'Connection Closed...')
+
+  def copy_attr(self, attr):
+    if attr == '_stats':
+      return dict([(key, type(self._stats[key])(self._stats[key])) for key in self._stats])
+    else:
+      return panel.Panel.copy_attr(self, attr)
+
+  def _update_accounting(self, event):
+    if not CONFIG['features.graph.bw.accounting.show']:
+      self._accounting_stats = None
+    elif not self._accounting_stats or time.time() - self._accounting_stats.retrieved >= ACCOUNTING_RATE:
+      old_accounting_stats = self._accounting_stats
+      self._accounting_stats = tor_controller().get_accounting_stats(None)
+
+      # if we either added or removed accounting info then redraw the whole
+      # screen to account for resizing
+
+      if bool(old_accounting_stats) != bool(self._accounting_stats):
+        nyx.controller.get_controller().redraw()
+
+  def _update_stats(self, event):
+    for stat in self._stats.values():
+      stat.bandwidth_event(event)
+
+    if self.displayed_stat:
+      param = self.get_attr('_stats')[self.displayed_stat]
+      update_rate = INTERVAL_SECONDS[self.update_interval]
+
+      if param.primary.tick % update_rate == 0:
+        self.redraw(True)
+
+
+def _size_label(byte_count, decimal = 1):
+  """
+  Alias for str_tools.size_label() that accounts for if the user prefers bits
+  or bytes.
+  """
+
+  return str_tools.size_label(byte_count, decimal, is_bytes = CONFIG['features.graph.bw.transferInBytes'])
diff --git a/nyx/panel/header.py b/nyx/panel/header.py
new file mode 100644
index 0000000..0d6591a
--- /dev/null
+++ b/nyx/panel/header.py
@@ -0,0 +1,496 @@
+"""
+Top panel for every page, containing basic system and tor related information.
+This expands the information it presents to two columns if there's room
+available.
+"""
+
+import collections
+import os
+import time
+import curses
+import threading
+
+import stem
+
+import nyx.controller
+import nyx.popups
+
+from stem.control import Listener, State
+from stem.util import conf, log, proc, str_tools, system
+from nyx.util import msg, tor_controller, panel, tracker
+
+MIN_DUAL_COL_WIDTH = 141  # minimum width where we'll show two columns
+SHOW_FD_THRESHOLD = 60  # show file descriptor usage if usage is over this percentage
+UPDATE_RATE = 5  # rate in seconds at which we refresh
+
+CONFIG = conf.config_dict('nyx', {
+  'attr.flag_colors': {},
+  'attr.version_status_colors': {},
+})
+
+
+class HeaderPanel(panel.Panel, threading.Thread):
+  """
+  Top area containing tor settings and system information.
+  """
+
+  def __init__(self, stdscr):
+    panel.Panel.__init__(self, stdscr, 'header', 0)
+    threading.Thread.__init__(self)
+    self.setDaemon(True)
+
+    self._vals = get_sampling()
+
+    self._pause_condition = threading.Condition()
+    self._halt = False  # terminates thread if true
+    self._reported_inactive = False
+
+    tor_controller().add_status_listener(self.reset_listener)
+
+  def is_wide(self, width = None):
+    """
+    True if we should show two columns of information, False otherwise.
+    """
+
+    if width is None:
+      width = self.get_parent().getmaxyx()[1]
+
+    return width >= MIN_DUAL_COL_WIDTH
+
+  def get_height(self):
+    """
+    Provides the height of the content, which is dynamically determined by the
+    panel's maximum width.
+    """
+
+    if self._vals.is_relay:
+      return 4 if self.is_wide() else 6
+    else:
+      return 3 if self.is_wide() else 4
+
+  def send_newnym(self):
+    """
+    Requests a new identity and provides a visual queue.
+    """
+
+    controller = tor_controller()
+
+    if not controller.is_newnym_available():
+      return
+
+    controller.signal(stem.Signal.NEWNYM)
+
+    # If we're wide then the newnym label in this panel will give an
+    # indication that the signal was sent. Otherwise use a msg.
+
+    if not self.is_wide():
+      nyx.popups.show_msg('Requesting a new identity', 1)
+
+  def handle_key(self, key):
+    if key.match('n'):
+      self.send_newnym()
+    elif key.match('r') and not self._vals.is_connected:
+      # TODO: This is borked. Not quite sure why but our attempt to call
+      # PROTOCOLINFO fails with a socket error, followed by completely freezing
+      # nyx. This is exposing two bugs...
+      #
+      # * This should be working. That's a stem issue.
+      # * Our interface shouldn't be locking up. That's an nyx issue.
+
+      return True
+
+      controller = tor_controller()
+
+      try:
+        controller.connect()
+
+        try:
+          controller.authenticate()  # TODO: should account for our chroot
+        except stem.connection.MissingPassword:
+          password = nyx.popups.input_prompt('Controller Password: ')
+
+          if password:
+            controller.authenticate(password)
+
+        log.notice("Reconnected to Tor's control port")
+        nyx.popups.show_msg('Tor reconnected', 1)
+      except Exception as exc:
+        nyx.popups.show_msg('Unable to reconnect (%s)' % exc, 3)
+        controller.close()
+    else:
+      return False
+
+    return True
+
+  def draw(self, width, height):
+    vals = self._vals  # local reference to avoid concurrency concerns
+    is_wide = self.is_wide(width)
+
+    # space available for content
+
+    left_width = max(width / 2, 77) if is_wide else width
+    right_width = width - left_width
+
+    self._draw_platform_section(0, 0, left_width, vals)
+
+    if vals.is_connected:
+      self._draw_ports_section(0, 1, left_width, vals)
+    else:
+      self._draw_disconnected(0, 1, left_width, vals)
+
+    if is_wide:
+      self._draw_resource_usage(left_width, 0, right_width, vals)
+
+      if vals.is_relay:
+        self._draw_fingerprint_and_fd_usage(left_width, 1, right_width, vals)
+        self._draw_flags(0, 2, left_width, vals)
+        self._draw_exit_policy(left_width, 2, right_width, vals)
+      elif vals.is_connected:
+        self._draw_newnym_option(left_width, 1, right_width, vals)
+    else:
+      self._draw_resource_usage(0, 2, left_width, vals)
+
+      if vals.is_relay:
+        self._draw_fingerprint_and_fd_usage(0, 3, left_width, vals)
+        self._draw_flags(0, 4, left_width, vals)
+
+  def _draw_platform_section(self, x, y, width, vals):
+    """
+    Section providing the user's hostname, platform, and version information...
+
+      nyx - odin (Linux 3.5.0-52-generic)        Tor 0.2.5.1-alpha-dev (unrecommended)
+      |------ platform (40 characters) ------|   |----------- tor version -----------|
+    """
+
+    initial_x, space_left = x, min(width, 40)
+
+    x = self.addstr(y, x, vals.format('nyx - {hostname}', space_left))
+    space_left -= x - initial_x
+
+    if space_left >= 10:
+      self.addstr(y, x, ' (%s)' % vals.format('{platform}', space_left - 3))
+
+    x, space_left = initial_x + 43, width - 43
+
+    if vals.version != 'Unknown' and space_left >= 10:
+      x = self.addstr(y, x, vals.format('Tor {version}', space_left))
+      space_left -= x - 43 - initial_x
+
+      if space_left >= 7 + len(vals.version_status):
+        version_color = CONFIG['attr.version_status_colors'].get(vals.version_status, 'white')
+
+        x = self.addstr(y, x, ' (')
+        x = self.addstr(y, x, vals.version_status, version_color)
+        self.addstr(y, x, ')')
+
+  def _draw_ports_section(self, x, y, width, vals):
+    """
+    Section providing our nickname, address, and port information...
+
+      Unnamed - 0.0.0.0:7000, Control Port (cookie): 9051
+    """
+
+    if not vals.is_relay:
+      x = self.addstr(y, x, 'Relaying Disabled', 'cyan')
+    else:
+      x = self.addstr(y, x, vals.format('{nickname} - {address}:{or_port}'))
+
+      if vals.dir_port != '0':
+        x = self.addstr(y, x, vals.format(', Dir Port: {dir_port}'))
+
+    if vals.control_port:
+      if width >= x + 19 + len(vals.control_port) + len(vals.auth_type):
+        auth_color = 'red' if vals.auth_type == 'open' else 'green'
+
+        x = self.addstr(y, x, ', Control Port (')
+        x = self.addstr(y, x, vals.auth_type, auth_color)
+        self.addstr(y, x, vals.format('): {control_port}'))
+      else:
+        self.addstr(y, x, vals.format(', Control Port: {control_port}'))
+    elif vals.socket_path:
+      self.addstr(y, x, vals.format(', Control Socket: {socket_path}'))
+
+  def _draw_disconnected(self, x, y, width, vals):
+    """
+    Message indicating that tor is disconnected...
+
+      Tor Disconnected (15:21 07/13/2014, press r to reconnect)
+    """
+
+    x = self.addstr(y, x, 'Tor Disconnected', curses.A_BOLD, 'red')
+    last_heartbeat = time.strftime('%H:%M %m/%d/%Y', time.localtime(vals.last_heartbeat))
+    self.addstr(y, x, ' (%s, press r to reconnect)' % last_heartbeat)
+
+  def _draw_resource_usage(self, x, y, width, vals):
+    """
+    System resource usage of the tor process...
+
+      cpu: 0.0% tor, 1.0% nyx    mem: 0 (0.0%)       pid: 16329  uptime: 12-20:42:07
+    """
+
+    if vals.start_time:
+      if not vals.is_connected:
+        now = vals.connection_time
+      elif self.is_paused():
+        now = self.get_pause_time()
+      else:
+        now = time.time()
+
+      uptime = str_tools.short_time_label(now - vals.start_time)
+    else:
+      uptime = ''
+
+    sys_fields = (
+      (0, vals.format('cpu: {tor_cpu}% tor, {nyx_cpu}% nyx')),
+      (27, vals.format('mem: {memory} ({memory_percent}%)')),
+      (47, vals.format('pid: {pid}')),
+      (59, 'uptime: %s' % uptime),
+    )
+
+    for (start, label) in sys_fields:
+      if width >= start + len(label):
+        self.addstr(y, x + start, label)
+      else:
+        break
+
+  def _draw_fingerprint_and_fd_usage(self, x, y, width, vals):
+    """
+    Presents our fingerprint, and our file descriptor usage if we're running
+    out...
+
+      fingerprint: 1A94D1A794FCB2F8B6CBC179EF8FDD4008A98D3B, file desc: 900 / 1000 (90%)
+    """
+
+    initial_x, space_left = x, width
+
+    x = self.addstr(y, x, vals.format('fingerprint: {fingerprint}', width))
+    space_left -= x - initial_x
+
+    if space_left >= 30 and vals.fd_used and vals.fd_limit != -1:
+      fd_percent = 100 * vals.fd_used / vals.fd_limit
+
+      if fd_percent >= SHOW_FD_THRESHOLD:
+        if fd_percent >= 95:
+          percentage_format = (curses.A_BOLD, 'red')
+        elif fd_percent >= 90:
+          percentage_format = ('red',)
+        elif fd_percent >= 60:
+          percentage_format = ('yellow',)
+        else:
+          percentage_format = ()
+
+        x = self.addstr(y, x, ', file descriptors' if space_left >= 37 else ', file desc')
+        x = self.addstr(y, x, vals.format(': {fd_used} / {fd_limit} ('))
+        x = self.addstr(y, x, '%i%%' % fd_percent, *percentage_format)
+        self.addstr(y, x, ')')
+
+  def _draw_flags(self, x, y, width, vals):
+    """
+    Presents flags held by our relay...
+
+      flags: Running, Valid
+    """
+
+    x = self.addstr(y, x, 'flags: ')
+
+    if vals.flags:
+      for i, flag in enumerate(vals.flags):
+        flag_color = CONFIG['attr.flag_colors'].get(flag, 'white')
+        x = self.addstr(y, x, flag, curses.A_BOLD, flag_color)
+
+        if i < len(vals.flags) - 1:
+          x = self.addstr(y, x, ', ')
+    else:
+      self.addstr(y, x, 'none', curses.A_BOLD, 'cyan')
+
+  def _draw_exit_policy(self, x, y, width, vals):
+    """
+    Presents our exit policy...
+
+      exit policy: reject *:*
+    """
+
+    x = self.addstr(y, x, 'exit policy: ')
+
+    if not vals.exit_policy:
+      return
+
+    rules = list(vals.exit_policy.strip_private().strip_default())
+
+    for i, rule in enumerate(rules):
+      policy_color = 'green' if rule.is_accept else 'red'
+      x = self.addstr(y, x, str(rule), curses.A_BOLD, policy_color)
+
+      if i < len(rules) - 1:
+        x = self.addstr(y, x, ', ')
+
+    if vals.exit_policy.has_default():
+      if rules:
+        x = self.addstr(y, x, ', ')
+
+      self.addstr(y, x, '<default>', curses.A_BOLD, 'cyan')
+
+  def _draw_newnym_option(self, x, y, width, vals):
+    """
+    Provide a notice for requiesting a new identity, and time until it's next
+    available if in the process of building circuits.
+    """
+
+    if vals.newnym_wait == 0:
+      self.addstr(y, x, "press 'n' for a new identity")
+    else:
+      plural = 's' if vals.newnym_wait > 1 else ''
+      self.addstr(y, x, 'building circuits, available again in %i second%s' % (vals.newnym_wait, plural))
+
+  def run(self):
+    """
+    Keeps stats updated, checking for new information at a set rate.
+    """
+
+    last_ran = -1
+
+    while not self._halt:
+      if self.is_paused() or not self._vals.is_connected or (time.time() - last_ran) < UPDATE_RATE:
+        with self._pause_condition:
+          if not self._halt:
+            self._pause_condition.wait(0.2)
+
+        continue  # done waiting, try again
+
+      self._update()
+      last_ran = time.time()
+
+  def stop(self):
+    """
+    Halts further resolutions and terminates the thread.
+    """
+
+    with self._pause_condition:
+      self._halt = True
+      self._pause_condition.notifyAll()
+
+  def reset_listener(self, controller, event_type, _):
+    self._update()
+
+    if event_type == State.CLOSED:
+      log.notice('Tor control port closed')
+
+  def _update(self):
+    previous_height = self.get_height()
+    self._vals = get_sampling(self._vals)
+
+    if self._vals.fd_used and self._vals.fd_limit != -1:
+      fd_percent = 100 * self._vals.fd_used / self._vals.fd_limit
+
+      if fd_percent >= 90:
+        log_msg = msg('panel.header.fd_used_at_ninety_percent', percentage = fd_percent)
+        log.log_once('fd_used_at_ninety_percent', log.WARN, log_msg)
+        log.DEDUPLICATION_MESSAGE_IDS.add('fd_used_at_sixty_percent')
+      elif fd_percent >= 60:
+        log_msg = msg('panel.header.fd_used_at_sixty_percent', percentage = fd_percent)
+        log.log_once('fd_used_at_sixty_percent', log.NOTICE, log_msg)
+
+    if self._vals.is_connected:
+      if not self._reported_inactive and (time.time() - self._vals.last_heartbeat) >= 10:
+        self._reported_inactive = True
+        log.notice('Relay unresponsive (last heartbeat: %s)' % time.ctime(self._vals.last_heartbeat))
+      elif self._reported_inactive and (time.time() - self._vals.last_heartbeat) < 10:
+        self._reported_inactive = False
+        log.notice('Relay resumed')
+
+    if previous_height != self.get_height():
+      # We're toggling between being a relay and client, causing the height
+      # of this panel to change. Redraw all content so we don't get
+      # overlapping content.
+
+      nyx.controller.get_controller().redraw()
+    else:
+      self.redraw(True)  # just need to redraw ourselves
+
+
+def get_sampling(last_sampling = None):
+  controller = tor_controller()
+  retrieved = time.time()
+
+  pid = controller.get_pid('')
+  tor_resources = tracker.get_resource_tracker().get_value()
+  nyx_total_cpu_time = sum(os.times()[:3])
+
+  or_listeners = controller.get_listeners(Listener.OR, [])
+  control_listeners = controller.get_listeners(Listener.CONTROL, [])
+
+  if controller.get_conf('HashedControlPassword', None):
+    auth_type = 'password'
+  elif controller.get_conf('CookieAuthentication', None) == '1':
+    auth_type = 'cookie'
+  else:
+    auth_type = 'open'
+
+  try:
+    fd_used = proc.file_descriptors_used(pid)
+  except IOError:
+    fd_used = None
+
+  if last_sampling:
+    nyx_cpu_delta = nyx_total_cpu_time - last_sampling.nyx_total_cpu_time
+    nyx_time_delta = retrieved - last_sampling.retrieved
+
+    python_cpu_time = nyx_cpu_delta / nyx_time_delta
+    sys_call_cpu_time = 0.0  # TODO: add a wrapper around call() to get this
+
+    nyx_cpu = python_cpu_time + sys_call_cpu_time
+  else:
+    nyx_cpu = 0.0
+
+  attr = {
+    'retrieved': retrieved,
+    'is_connected': controller.is_alive(),
+    'connection_time': controller.connection_time(),
+    'last_heartbeat': controller.get_latest_heartbeat(),
+
+    'fingerprint': controller.get_info('fingerprint', 'Unknown'),
+    'nickname': controller.get_conf('Nickname', ''),
+    'newnym_wait': controller.get_newnym_wait(),
+    'exit_policy': controller.get_exit_policy(None),
+    'flags': getattr(controller.get_network_status(default = None), 'flags', []),
+
+    'version': str(controller.get_version('Unknown')).split()[0],
+    'version_status': controller.get_info('status/version/current', 'Unknown'),
+
+    'address': or_listeners[0][0] if (or_listeners and or_listeners[0][0] != '0.0.0.0') else controller.get_info('address', 'Unknown'),
+    'or_port': or_listeners[0][1] if or_listeners else '',
+    'dir_port': controller.get_conf('DirPort', '0'),
+    'control_port': str(control_listeners[0][1]) if control_listeners else None,
+    'socket_path': controller.get_conf('ControlSocket', None),
+    'is_relay': bool(or_listeners),
+
+    'auth_type': auth_type,
+    'pid': pid,
+    'start_time': system.start_time(pid),
+    'fd_limit': int(controller.get_info('process/descriptor-limit', '-1')),
+    'fd_used': fd_used,
+
+    'nyx_total_cpu_time': nyx_total_cpu_time,
+    'tor_cpu': '%0.1f' % (100 * tor_resources.cpu_sample),
+    'nyx_cpu': nyx_cpu,
+    'memory': str_tools.size_label(tor_resources.memory_bytes) if tor_resources.memory_bytes > 0 else 0,
+    'memory_percent': '%0.1f' % (100 * tor_resources.memory_percent),
+
+    'hostname': os.uname()[1],
+    'platform': '%s %s' % (os.uname()[0], os.uname()[2]),  # [platform name] [version]
+  }
+
+  class Sampling(collections.namedtuple('Sampling', attr.keys())):
+    def __init__(self, **attr):
+      super(Sampling, self).__init__(**attr)
+      self._attr = attr
+
+    def format(self, message, crop_width = None):
+      formatted_msg = message.format(**self._attr)
+
+      if crop_width:
+        formatted_msg = str_tools.crop(formatted_msg, crop_width)
+
+      return formatted_msg
+
+  return Sampling(**attr)
diff --git a/nyx/panel/log.py b/nyx/panel/log.py
new file mode 100644
index 0000000..708a679
--- /dev/null
+++ b/nyx/panel/log.py
@@ -0,0 +1,454 @@
+"""
+Panel providing a chronological log of events its been configured to listen
+for. This provides prepopulation from the log file and supports filtering by
+regular expressions.
+"""
+
+import os
+import time
+import curses
+import threading
+
+import stem.response.events
+
+import nyx.arguments
+import nyx.popups
+import nyx.util.log
+
+from nyx.util import join, panel, tor_controller, ui_tools
+from stem.util import conf, log
+
+
+def conf_handler(key, value):
+  if key == 'features.log.prepopulateReadLimit':
+    return max(0, value)
+  elif key == 'features.log.maxRefreshRate':
+    return max(10, value)
+  elif key == 'cache.log_panel.size':
+    return max(1000, value)
+
+
+CONFIG = conf.config_dict('nyx', {
+  'attr.log_color': {},
+  'cache.log_panel.size': 1000,
+  'features.logFile': '',
+  'features.log.showDuplicateEntries': False,
+  'features.log.prepopulate': True,
+  'features.log.prepopulateReadLimit': 5000,
+  'features.log.maxRefreshRate': 300,
+  'features.log.regex': [],
+  'msg.misc.event_types': '',
+  'startup.events': 'N3',
+}, conf_handler)
+
+# The height of the drawn content is estimated based on the last time we redrew
+# the panel. It's chiefly used for scrolling and the bar indicating its
+# position. Letting the estimate be too inaccurate results in a display bug, so
+# redraws the display if it's off by this threshold.
+
+CONTENT_HEIGHT_REDRAW_THRESHOLD = 3
+
+# Log buffer so we start collecting stem/nyx events when imported. This is used
+# to make our LogPanel when curses initializes.
+
+stem_logger = log.get_logger()
+NYX_LOGGER = log.LogBuffer(log.Runlevel.DEBUG, yield_records = True)
+stem_logger.addHandler(NYX_LOGGER)
+
+
+class LogPanel(panel.Panel, threading.Thread):
+  """
+  Listens for and displays tor, nyx, and stem events. This prepopulates
+  from tor's log file if it exists.
+  """
+
+  def __init__(self, stdscr):
+    panel.Panel.__init__(self, stdscr, 'log', 0)
+    threading.Thread.__init__(self)
+    self.setDaemon(True)
+
+    logged_events = nyx.arguments.expand_events(CONFIG['startup.events'])
+    self._event_log = nyx.util.log.LogGroup(CONFIG['cache.log_panel.size'], group_by_day = True)
+    self._event_types = nyx.util.log.listen_for_events(self._register_tor_event, logged_events)
+    self._log_file = nyx.util.log.LogFileOutput(CONFIG['features.logFile'])
+    self._filter = nyx.util.log.LogFilters(initial_filters = CONFIG['features.log.regex'])
+    self._show_duplicates = CONFIG['features.log.showDuplicateEntries']
+
+    self.set_pause_attr('_event_log')
+
+    self._halt = False  # terminates thread if true
+    self._pause_condition = threading.Condition()
+    self._has_new_event = False
+
+    # fetches past tor events from log file, if available
+
+    if CONFIG['features.log.prepopulate']:
+      log_location = nyx.util.log.log_file_path(tor_controller())
+
+      if log_location:
+        try:
+          for entry in reversed(list(nyx.util.log.read_tor_log(log_location, CONFIG['features.log.prepopulateReadLimit']))):
+            if entry.type in self._event_types:
+              self._event_log.add(entry)
+        except IOError as exc:
+          log.info('Unable to read log located at %s: %s' % (log_location, exc))
+        except ValueError as exc:
+          log.info(str(exc))
+
+    self._last_content_height = len(self._event_log)  # height of the rendered content when last drawn
+    self._scroll = 0
+
+    # merge NYX_LOGGER into us, and listen for its future events
+
+    for event in NYX_LOGGER:
+      self._register_nyx_event(event)
+
+    NYX_LOGGER.emit = self._register_nyx_event
+
+  def set_duplicate_visability(self, is_visible):
+    """
+    Sets if duplicate log entries are collaped or expanded.
+
+    :param bool is_visible: if **True** all log entries are shown, otherwise
+      they're deduplicated
+    """
+
+    self._show_duplicates = is_visible
+
+  def get_filter(self):
+    """
+    Provides our currently selected regex filter.
+    """
+
+    return self._filter
+
+  def show_filter_prompt(self):
+    """
+    Prompts the user to add a new regex filter.
+    """
+
+    regex_input = nyx.popups.input_prompt('Regular expression: ')
+
+    if regex_input:
+      self._filter.select(regex_input)
+
+  def show_event_selection_prompt(self):
+    """
+    Prompts the user to select the events being listened for.
+    """
+
+    # allow user to enter new types of events to log - unchanged if left blank
+
+    with nyx.popups.popup_window(16, 80) as (popup, width, height):
+      if popup:
+        # displays the available flags
+
+        popup.win.box()
+        popup.addstr(0, 0, 'Event Types:', curses.A_STANDOUT)
+        event_lines = CONFIG['msg.misc.event_types'].split('\n')
+
+        for i in range(len(event_lines)):
+          popup.addstr(i + 1, 1, event_lines[i][6:])
+
+        popup.win.refresh()
+
+        user_input = nyx.popups.input_prompt('Events to log: ')
+
+        if user_input:
+          try:
+            user_input = user_input.replace(' ', '')  # strip spaces
+            event_types = nyx.arguments.expand_events(user_input)
+
+            if event_types != self._event_types:
+              self._event_types = nyx.util.log.listen_for_events(self._register_tor_event, event_types)
+              self.redraw(True)
+          except ValueError as exc:
+            nyx.popups.show_msg('Invalid flags: %s' % str(exc), 2)
+
+  def show_snapshot_prompt(self):
+    """
+    Lets user enter a path to take a snapshot, canceling if left blank.
+    """
+
+    path_input = nyx.popups.input_prompt('Path to save log snapshot: ')
+
+    if path_input:
+      try:
+        self.save_snapshot(path_input)
+        nyx.popups.show_msg('Saved: %s' % path_input, 2)
+      except IOError as exc:
+        nyx.popups.show_msg('Unable to save snapshot: %s' % exc, 2)
+
+  def clear(self):
+    """
+    Clears the contents of the event log.
+    """
+
+    self._event_log = nyx.util.log.LogGroup(CONFIG['cache.log_panel.size'], group_by_day = True)
+    self.redraw(True)
+
+  def save_snapshot(self, path):
+    """
+    Saves the log events currently being displayed to the given path. This
+    takes filers into account. This overwrites the file if it already exists.
+
+    :param str path: path where to save the log snapshot
+
+    :raises: **IOError** if unsuccessful
+    """
+
+    path = os.path.abspath(os.path.expanduser(path))
+
+    # make dir if the path doesn't already exist
+
+    base_dir = os.path.dirname(path)
+
+    try:
+      if not os.path.exists(base_dir):
+        os.makedirs(base_dir)
+    except OSError as exc:
+      raise IOError("unable to make directory '%s'" % base_dir)
+
+    event_log = list(self._event_log)
+    event_filter = self._filter.clone()
+
+    with open(path, 'w') as snapshot_file:
+      try:
+        for entry in reversed(event_log):
+          if event_filter.match(entry.display_message):
+            snapshot_file.write(entry.display_message + '\n')
+      except Exception as exc:
+        raise IOError("unable to write to '%s': %s" % (path, exc))
+
+  def handle_key(self, key):
+    if key.is_scroll():
+      page_height = self.get_preferred_size()[0] - 1
+      new_scroll = ui_tools.get_scroll_position(key, self._scroll, page_height, self._last_content_height)
+
+      if self._scroll != new_scroll:
+        self._scroll = new_scroll
+        self.redraw(True)
+    elif key.match('u'):
+      self.set_duplicate_visability(not self._show_duplicates)
+      self.redraw(True)
+    elif key.match('c'):
+      msg = 'This will clear the log. Are you sure (c again to confirm)?'
+      key_press = nyx.popups.show_msg(msg, attr = curses.A_BOLD)
+
+      if key_press.match('c'):
+        self.clear()
+    elif key.match('f'):
+      with panel.CURSES_LOCK:
+        initial_selection = 1 if self._filter.selection() else 0
+        options = ['None'] + self._filter.latest_selections() + ['New...']
+        selection = nyx.popups.show_menu('Log Filter:', options, initial_selection)
+
+        if selection == 0:
+          self._filter.select(None)
+        elif selection == len(options) - 1:
+          # selected 'New...' option - prompt user to input regular expression
+          self.show_filter_prompt()
+        elif selection != -1:
+          self._filter.select(self._filter.latest_selections()[selection - 1])
+    elif key.match('e'):
+      self.show_event_selection_prompt()
+    elif key.match('a'):
+      self.show_snapshot_prompt()
+    else:
+      return False
+
+    return True
+
+  def get_help(self):
+    return [
+      ('up arrow', 'scroll log up a line', None),
+      ('down arrow', 'scroll log down a line', None),
+      ('a', 'save snapshot of the log', None),
+      ('e', 'change logged events', None),
+      ('f', 'log regex filter', 'enabled' if self._filter.selection() else 'disabled'),
+      ('u', 'duplicate log entries', 'visible' if self._show_duplicates else 'hidden'),
+      ('c', 'clear event log', None),
+    ]
+
+  def draw(self, width, height):
+    self._scroll = max(0, min(self._scroll, self._last_content_height - height + 1))
+
+    event_log = list(self.get_attr('_event_log'))
+    event_filter = self._filter.clone()
+    event_types = list(self._event_types)
+    scroll = int(self._scroll)
+    last_content_height = self._last_content_height
+    show_duplicates = self._show_duplicates
+
+    is_scrollbar_visible = last_content_height > height - 1
+
+    if is_scrollbar_visible:
+      self.add_scroll_bar(scroll, scroll + height - 1, last_content_height, 1)
+
+    x, y = 3 if is_scrollbar_visible else 1, 1 - scroll
+
+    # group entries by date, filtering out those that aren't visible
+
+    day_to_entries, today = {}, nyx.util.log.day_count(time.time())
+
+    for entry in event_log:
+      if entry.is_duplicate and not show_duplicates:
+        continue  # deduplicated message
+      elif not event_filter.match(entry.display_message):
+        continue  # filter doesn't match log message
+
+      day_to_entries.setdefault(entry.day_count(), []).append(entry)
+
+    for day in sorted(day_to_entries.keys(), reverse = True):
+      if day == today:
+        for entry in day_to_entries[day]:
+          y = self._draw_entry(x, y, width, entry, show_duplicates)
+      else:
+        original_y, y = y, y + 1
+
+        for entry in day_to_entries[day]:
+          y = self._draw_entry(x, y, width, entry, show_duplicates)
+
+        ui_tools.draw_box(self, original_y, x - 1, width - x + 1, y - original_y + 1, curses.A_BOLD, 'yellow')
+        time_label = time.strftime(' %B %d, %Y ', time.localtime(day_to_entries[day][0].timestamp))
+        self.addstr(original_y, x + 1, time_label, curses.A_BOLD, curses.A_BOLD, 'yellow')
+
+        y += 1
+
+    # drawing the title after the content, so we'll clear content from the top line
+
+    if self.is_title_visible():
+      self._draw_title(width, event_types, event_filter)
+
+    # redraw the display if...
+    # - last_content_height was off by too much
+    # - we're off the bottom of the page
+
+    new_content_height = y + scroll - 1
+    content_height_delta = abs(last_content_height - new_content_height)
+    force_redraw, force_redraw_reason = True, ''
+
+    if content_height_delta >= CONTENT_HEIGHT_REDRAW_THRESHOLD:
+      force_redraw_reason = 'estimate was off by %i' % content_height_delta
+    elif new_content_height > height and self._scroll + height - 1 > new_content_height:
+      force_redraw_reason = 'scrolled off the bottom of the page'
+    elif not is_scrollbar_visible and new_content_height > height - 1:
+      force_redraw_reason = "scroll bar wasn't previously visible"
+    elif is_scrollbar_visible and new_content_height <= height - 1:
+      force_redraw_reason = "scroll bar shouldn't be visible"
+    else:
+      force_redraw = False
+
+    self._last_content_height = new_content_height
+    self._has_new_event = False
+
+    if force_redraw:
+      log.debug('redrawing the log panel with the corrected content height (%s)' % force_redraw_reason)
+      self.redraw(True)
+
+  def _draw_title(self, width, event_types, event_filter):
+    """
+    Panel title with the event types we're logging and our regex filter if set.
+    """
+
+    self.addstr(0, 0, ' ' * width)  # clear line
+    title_comp = list(nyx.util.log.condense_runlevels(*event_types))
+
+    if event_filter.selection():
+      title_comp.append('filter: %s' % event_filter.selection())
+
+    title_comp_str = join(title_comp, ', ', width - 10)
+    title = 'Events (%s):' % title_comp_str if title_comp_str else 'Events:'
+
+    self.addstr(0, 0, title, curses.A_STANDOUT)
+
+  def _draw_entry(self, x, y, width, entry, show_duplicates):
+    """
+    Presents a log entry with line wrapping.
+    """
+
+    min_x, msg = x + 2, entry.display_message
+    boldness = curses.A_BOLD if 'ERR' in entry.type else curses.A_NORMAL  # emphasize ERR messages
+    color = CONFIG['attr.log_color'].get(entry.type, 'white')
+
+    for line in msg.splitlines():
+      x, y = self.addstr_wrap(y, x, line, width, min_x, boldness, color)
+
+    if entry.duplicates and not show_duplicates:
+      duplicate_count = len(entry.duplicates) - 1
+      plural = 's' if duplicate_count > 1 else ''
+      duplicate_msg = ' [%i duplicate%s hidden]' % (duplicate_count, plural)
+      x, y = self.addstr_wrap(y, x, duplicate_msg, width, min_x, curses.A_BOLD, 'green')
+
+    return y + 1
+
+  def run(self):
+    """
+    Redraws the display, coalescing updates if events are rapidly logged (for
+    instance running at the DEBUG runlevel) while also being immediately
+    responsive if additions are less frequent.
+    """
+
+    last_ran, last_day = -1, nyx.util.log.day_count(time.time())
+
+    while not self._halt:
+      current_day = nyx.util.log.day_count(time.time())
+      time_since_reset = time.time() - last_ran
+      max_log_update_rate = CONFIG['features.log.maxRefreshRate'] / 1000.0
+
+      sleep_time = 0
+
+      if (not self._has_new_event and last_day == current_day) or self.is_paused():
+        sleep_time = 5
+      elif time_since_reset < max_log_update_rate:
+        sleep_time = max(0.05, max_log_update_rate - time_since_reset)
+
+      if sleep_time:
+        with self._pause_condition:
+          if not self._halt:
+            self._pause_condition.wait(sleep_time)
+
+        continue
+
+      last_ran, last_day = time.time(), current_day
+      self.redraw(True)
+
+  def stop(self):
+    """
+    Halts further updates and terminates the thread.
+    """
+
+    with self._pause_condition:
+      self._halt = True
+      self._pause_condition.notifyAll()
+
+  def _register_tor_event(self, event):
+    msg = ' '.join(str(event).split(' ')[1:])
+
+    if isinstance(event, stem.response.events.BandwidthEvent):
+      msg = 'READ: %i, WRITTEN: %i' % (event.read, event.written)
+    elif isinstance(event, stem.response.events.LogEvent):
+      msg = event.message
+
+    self._register_event(nyx.util.log.LogEntry(event.arrived_at, event.type, msg))
+
+  def _register_nyx_event(self, record):
+    if record.levelname == 'WARNING':
+      record.levelname = 'WARN'
+
+    self._register_event(nyx.util.log.LogEntry(int(record.created), 'NYX_%s' % record.levelname, record.msg))
+
+  def _register_event(self, event):
+    if event.type not in self._event_types:
+      return
+
+    self._event_log.add(event)
+    self._log_file.write(event.display_message)
+
+    # notifies the display that it has new content
+
+    if self._filter.match(event.display_message):
+      self._has_new_event = True
+
+      with self._pause_condition:
+        self._pause_condition.notifyAll()
diff --git a/nyx/panel/torrc.py b/nyx/panel/torrc.py
new file mode 100644
index 0000000..f0f66b4
--- /dev/null
+++ b/nyx/panel/torrc.py
@@ -0,0 +1,171 @@
+"""
+Panel displaying the torrc or nyxrc with the validation done against it.
+"""
+
+import math
+import curses
+
+from nyx.util import expand_path, msg, panel, tor_controller, ui_tools
+
+from stem import ControllerError
+from stem.control import State
+
+
+class TorrcPanel(panel.Panel):
+  """
+  Renders the current torrc or nyxrc with syntax highlighting in a scrollable
+  area.
+  """
+
+  def __init__(self, stdscr):
+    panel.Panel.__init__(self, stdscr, 'torrc', 0)
+
+    self._scroll = 0
+    self._show_line_numbers = True  # shows left aligned line numbers
+    self._show_comments = True  # shows comments and extra whitespace
+    self._last_content_height = 0
+
+    self._torrc_location = None
+    self._torrc_content = None
+    self._torrc_load_error = None
+
+    controller = tor_controller()
+    controller.add_status_listener(self.reset_listener)
+    self.reset_listener(controller, State.RESET, None)
+
+  def reset_listener(self, controller, event_type, _):
+    """
+    Reloads and displays the torrc on tor reload (sighup) events.
+    """
+
+    if event_type == State.RESET:
+      try:
+        self._torrc_location = expand_path(controller.get_info('config-file'))
+
+        with open(self._torrc_location) as torrc_file:
+          self._torrc_content = [ui_tools.get_printable(line.replace('\t', '   ')).rstrip() for line in torrc_file.readlines()]
+      except ControllerError as exc:
+        self._torrc_load_error = msg('panel.torrc.unable_to_find_torrc', error = exc)
+        self._torrc_location = None
+        self._torrc_content = None
+      except Exception as exc:
+        self._torrc_load_error = msg('panel.torrc.unable_to_load_torrc', error = exc.strerror)
+        self._torrc_content = None
+
+  def set_comments_visible(self, is_visible):
+    """
+    Sets if comments and blank lines are shown or stripped.
+
+    :var bool is_visible: shows comments if true, strips otherwise
+    """
+
+    self._show_comments = is_visible
+    self.redraw(True)
+
+  def set_line_number_visible(self, is_visible):
+    """
+    Sets if line numbers are shown or hidden.
+
+    :var bool is_visible: displays line numbers if true, hides otherwise
+    """
+
+    self._show_line_numbers = is_visible
+    self.redraw(True)
+
+  def handle_key(self, key):
+    if key.is_scroll():
+      page_height = self.get_preferred_size()[0] - 1
+      new_scroll = ui_tools.get_scroll_position(key, self._scroll, page_height, self._last_content_height)
+
+      if self._scroll != new_scroll:
+        self._scroll = new_scroll
+        self.redraw(True)
+    elif key.match('l'):
+      self.set_line_number_visible(not self._show_line_numbers)
+    elif key.match('s'):
+      self.set_comments_visible(not self._show_comments)
+    else:
+      return False
+
+    return True
+
+  def get_help(self):
+    return [
+      ('up arrow', 'scroll up a line', None),
+      ('down arrow', 'scroll down a line', None),
+      ('page up', 'scroll up a page', None),
+      ('page down', 'scroll down a page', None),
+      ('s', 'comment stripping', 'off' if self._show_comments else 'on'),
+      ('l', 'line numbering', 'on' if self._show_line_numbers else 'off'),
+      ('x', 'reset tor (issue sighup)', None),
+    ]
+
+  def draw(self, width, height):
+    if self._torrc_content is None:
+      self.addstr(1, 0, self._torrc_load_error, 'red', curses.A_BOLD)
+      new_content_height = 1
+    else:
+      self._scroll = max(0, min(self._scroll, self._last_content_height - height + 1))
+
+      if not self._show_line_numbers:
+        line_number_offset = 0
+      elif len(self._torrc_content) == 0:
+        line_number_offset = 2
+      else:
+        line_number_offset = int(math.log10(len(self._torrc_content))) + 2
+
+      scroll_offset = 0
+
+      if self._last_content_height > height - 1:
+        scroll_offset = 3
+        self.add_scroll_bar(self._scroll, self._scroll + height - 1, self._last_content_height, 1)
+
+      y = 1 - self._scroll
+      is_multiline = False  # true if we're in the middle of a multiline torrc entry
+
+      for line_number, line in enumerate(self._torrc_content):
+        if not self._show_comments:
+          line = line[:line.find('#')].rstrip() if '#' in line else line
+
+          if not line:
+            continue  # skip blank lines
+
+        if '#' in line:
+          line, comment = line.split('#', 1)
+          comment = '#' + comment
+        else:
+          comment = ''
+
+        if is_multiline:
+          option, argument = '', line  # previous line ended with a ''
+        elif ' ' not in line.strip():
+          option, argument = line, ''  # no argument
+        else:
+          whitespace = ' ' * (len(line) - len(line.strip()))
+          option, argument = line.strip().split(' ', 1)
+          option = whitespace + option + ' '
+
+        is_multiline = line.endswith('\')  # next line's part of a multi-line entry
+
+        if self._show_line_numbers:
+          self.addstr(y, scroll_offset, str(line_number + 1).rjust(line_number_offset - 1), curses.A_BOLD, 'yellow')
+
+        x = line_number_offset + scroll_offset
+        min_x = line_number_offset + scroll_offset
+
+        x, y = self.addstr_wrap(y, x, option, width, min_x, curses.A_BOLD, 'green')
+        x, y = self.addstr_wrap(y, x, argument, width, min_x, curses.A_BOLD, 'cyan')
+        x, y = self.addstr_wrap(y, x, comment, width, min_x, 'white')
+
+        y += 1
+
+      new_content_height = y + self._scroll - 1
+
+    if self.is_title_visible():
+      self.addstr(0, 0, ' ' * width)  # clear line
+      location = ' (%s)' % self._torrc_location if self._torrc_location else ''
+      self.addstr(0, 0, 'Tor Configuration File%s:' % location, curses.A_STANDOUT)
+
+    if self._last_content_height != new_content_height:
+      self._last_content_height = new_content_height
+      self.redraw(True)
diff --git a/nyx/torrc_panel.py b/nyx/torrc_panel.py
deleted file mode 100644
index f0f66b4..0000000
--- a/nyx/torrc_panel.py
+++ /dev/null
@@ -1,171 +0,0 @@
-"""
-Panel displaying the torrc or nyxrc with the validation done against it.
-"""
-
-import math
-import curses
-
-from nyx.util import expand_path, msg, panel, tor_controller, ui_tools
-
-from stem import ControllerError
-from stem.control import State
-
-
-class TorrcPanel(panel.Panel):
-  """
-  Renders the current torrc or nyxrc with syntax highlighting in a scrollable
-  area.
-  """
-
-  def __init__(self, stdscr):
-    panel.Panel.__init__(self, stdscr, 'torrc', 0)
-
-    self._scroll = 0
-    self._show_line_numbers = True  # shows left aligned line numbers
-    self._show_comments = True  # shows comments and extra whitespace
-    self._last_content_height = 0
-
-    self._torrc_location = None
-    self._torrc_content = None
-    self._torrc_load_error = None
-
-    controller = tor_controller()
-    controller.add_status_listener(self.reset_listener)
-    self.reset_listener(controller, State.RESET, None)
-
-  def reset_listener(self, controller, event_type, _):
-    """
-    Reloads and displays the torrc on tor reload (sighup) events.
-    """
-
-    if event_type == State.RESET:
-      try:
-        self._torrc_location = expand_path(controller.get_info('config-file'))
-
-        with open(self._torrc_location) as torrc_file:
-          self._torrc_content = [ui_tools.get_printable(line.replace('\t', '   ')).rstrip() for line in torrc_file.readlines()]
-      except ControllerError as exc:
-        self._torrc_load_error = msg('panel.torrc.unable_to_find_torrc', error = exc)
-        self._torrc_location = None
-        self._torrc_content = None
-      except Exception as exc:
-        self._torrc_load_error = msg('panel.torrc.unable_to_load_torrc', error = exc.strerror)
-        self._torrc_content = None
-
-  def set_comments_visible(self, is_visible):
-    """
-    Sets if comments and blank lines are shown or stripped.
-
-    :var bool is_visible: shows comments if true, strips otherwise
-    """
-
-    self._show_comments = is_visible
-    self.redraw(True)
-
-  def set_line_number_visible(self, is_visible):
-    """
-    Sets if line numbers are shown or hidden.
-
-    :var bool is_visible: displays line numbers if true, hides otherwise
-    """
-
-    self._show_line_numbers = is_visible
-    self.redraw(True)
-
-  def handle_key(self, key):
-    if key.is_scroll():
-      page_height = self.get_preferred_size()[0] - 1
-      new_scroll = ui_tools.get_scroll_position(key, self._scroll, page_height, self._last_content_height)
-
-      if self._scroll != new_scroll:
-        self._scroll = new_scroll
-        self.redraw(True)
-    elif key.match('l'):
-      self.set_line_number_visible(not self._show_line_numbers)
-    elif key.match('s'):
-      self.set_comments_visible(not self._show_comments)
-    else:
-      return False
-
-    return True
-
-  def get_help(self):
-    return [
-      ('up arrow', 'scroll up a line', None),
-      ('down arrow', 'scroll down a line', None),
-      ('page up', 'scroll up a page', None),
-      ('page down', 'scroll down a page', None),
-      ('s', 'comment stripping', 'off' if self._show_comments else 'on'),
-      ('l', 'line numbering', 'on' if self._show_line_numbers else 'off'),
-      ('x', 'reset tor (issue sighup)', None),
-    ]
-
-  def draw(self, width, height):
-    if self._torrc_content is None:
-      self.addstr(1, 0, self._torrc_load_error, 'red', curses.A_BOLD)
-      new_content_height = 1
-    else:
-      self._scroll = max(0, min(self._scroll, self._last_content_height - height + 1))
-
-      if not self._show_line_numbers:
-        line_number_offset = 0
-      elif len(self._torrc_content) == 0:
-        line_number_offset = 2
-      else:
-        line_number_offset = int(math.log10(len(self._torrc_content))) + 2
-
-      scroll_offset = 0
-
-      if self._last_content_height > height - 1:
-        scroll_offset = 3
-        self.add_scroll_bar(self._scroll, self._scroll + height - 1, self._last_content_height, 1)
-
-      y = 1 - self._scroll
-      is_multiline = False  # true if we're in the middle of a multiline torrc entry
-
-      for line_number, line in enumerate(self._torrc_content):
-        if not self._show_comments:
-          line = line[:line.find('#')].rstrip() if '#' in line else line
-
-          if not line:
-            continue  # skip blank lines
-
-        if '#' in line:
-          line, comment = line.split('#', 1)
-          comment = '#' + comment
-        else:
-          comment = ''
-
-        if is_multiline:
-          option, argument = '', line  # previous line ended with a ''
-        elif ' ' not in line.strip():
-          option, argument = line, ''  # no argument
-        else:
-          whitespace = ' ' * (len(line) - len(line.strip()))
-          option, argument = line.strip().split(' ', 1)
-          option = whitespace + option + ' '
-
-        is_multiline = line.endswith('\')  # next line's part of a multi-line entry
-
-        if self._show_line_numbers:
-          self.addstr(y, scroll_offset, str(line_number + 1).rjust(line_number_offset - 1), curses.A_BOLD, 'yellow')
-
-        x = line_number_offset + scroll_offset
-        min_x = line_number_offset + scroll_offset
-
-        x, y = self.addstr_wrap(y, x, option, width, min_x, curses.A_BOLD, 'green')
-        x, y = self.addstr_wrap(y, x, argument, width, min_x, curses.A_BOLD, 'cyan')
-        x, y = self.addstr_wrap(y, x, comment, width, min_x, 'white')
-
-        y += 1
-
-      new_content_height = y + self._scroll - 1
-
-    if self.is_title_visible():
-      self.addstr(0, 0, ' ' * width)  # clear line
-      location = ' (%s)' % self._torrc_location if self._torrc_location else ''
-      self.addstr(0, 0, 'Tor Configuration File%s:' % location, curses.A_STANDOUT)
-
-    if self._last_content_height != new_content_height:
-      self._last_content_height = new_content_height
-      self.redraw(True)
diff --git a/nyx/util/log.py b/nyx/util/log.py
index bf9fe82..e4f962b 100644
--- a/nyx/util/log.py
+++ b/nyx/util/log.py
@@ -4,7 +4,7 @@ runlevels.
::
-  trace - logs a message at the TRACE runlevel 
+  trace - logs a message at the TRACE runlevel
   debug - logs a message at the DEBUG runlevel
   info - logs a message at the INFO runlevel
   notice - logs a message at the NOTICE runlevel
diff --git a/setup.py b/setup.py
index 13ae6af..326cc61 100644
--- a/setup.py
+++ b/setup.py
@@ -99,7 +99,7 @@ setup(
   author = nyx.__author__,
   author_email = nyx.__contact__,
   url = nyx.__url__,
-  packages = ['nyx', 'nyx.menu', 'nyx.util'],
+  packages = ['nyx', 'nyx.panel', 'nyx.menu', 'nyx.util'],
   keywords = 'tor onion controller',
   install_requires = ['stem>=1.4.1'],
   package_data = {'nyx': ['settings/*', 'resources/*']},

    

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

[tor-commits] [nyx/master] Move panels into their own module