Quickly facilitate network service discovery.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



An in development network discovery service. Epyphany facilitates the broadcast of a discovery packet to the network so any number of clients running Epyphany can see it.

Getting Started

Epyphany supports python 3. To install it, simply run pip install epyphany.

Step 1

Initialize Epyphany using a port dedicated for discovery broadcasts. Here, we'll use 6000.

from epyphany import Epyphany, Service

epyphany = Epyphany(port=6000)

Step 2

Next, register a service. A service is generally hosted on a port that a client whom receives the broadcast can connect to. The port should not be the same as the discovery port. e.x. 6001

class TestService(Service):
  def __init__(self):
    # ('test', 6001) = Service ID, Service port
    #   Service ID should be unique
    #   Service Port is the port that the received client should attempt to connect to
    super(TestService, self).__init__('test', 6001)

  def start_service(self):
    # Start up the socket for clients to connect to using "Service Port"

  def create_payload(self):
    # Any additional data the client may need to know
    return {'foo': 'bar'}

# Register the service with Epyphany

Step 3

Then register a listener. This will be triggered every time it receives the broadcast packet. (By default, it would be approximately every 5 seconds)

def on_discovery_test(protocol, service):
  print('%s: %s:%d' % (service.id, service.ip, service.port))


  • Trevin Miller - Initial work - Stumblinbear
  • Bill Miller - Some creative inspiration and lots of frustration - Secretweb-com

See also the list of contributors who participated in this project.


This project is licensed under the MIT License - see the LICENSE file for details