Page MenuHomePhabricator

README
No OneTemporary

PyPjUA
------
http://pypjua.com
Copyright (c) 2008 AG Projects
http://ag-projects.com
Description
-----------
PyPjUA is Python software library for PJSIP C SIP stack that together with
an elegant middleware allows for easy development of real-time Internet
communications end-points based on SIP protocol with rich presence and IM
capability for computers running Mac OS X, Linux and Windows operating
systems or portable devices like Nokia Internet tablet, Apple iPhone and
Android mobile phone.
The goal of this project is to deliver the best Open Source development kit
for rich featured SIP User Agents, while hiding the complex underlying
functionality behind an easy to use high-level application programming
interface. Compared to other available SIP libraries, this project provides
session based Interactive Messaging (IM) using MSRP protocol, multiple
streams support, 'the missing' SIP-SIMPLE features for rich presence
(presence rules, resource lists, RLS services, RPIDF and XCAP policy).
The software library is tested against the most popular SIP server software
available today: OpenSER, OpenXCAP, MSRPRelay and MediaProxy.
End-user experiences
--------------------
This software allows you to create elegant real-time communications
applications without having to read the +1200 RFC documents behind it. If
you read them all, some antidepressant and desintoxication is recommended
after this effort.
As a library with a high-level API, the toolkit can also be used to add SIP
and Presence functionality to network devices without a display (like TV
set-up boxes), as long as Python environment is supported by such platform.
You may collapse the whole telecom industry into a simple Call me button or
expand the presence buddy list to display the mood or blood pressure of your
buddies (if they want to share this information with you). Some of the
things possible with this library are listed here:
- VoIP calls using Internet codecs (wide-band Speex, iLBC) and G.711
- Zero configuration server-less communication over LAN (Bonjour)
- Presence using SIP SIMPLE (PUBLISH, SUBSCRIBE, NOTIFY and XCAP policy)
- Interactive Messaging (IM) and File transfer using MSRP protocol
Testing the library
-------------------
Besides the Python software library itself, the repository contains the
ready to use command-line examples scripts for Linux and MacOSX that can be
used to:
- Setup IM or file-transfer sessions with or without support from a MSRP relay
- Setup up VoIP sessions with wide-band speex codec
- PUBLISH, SUBSCRIBE and handle incoming NOTIFY for SIP events like
presence, xcap-diff, watcher-info, conference, message-summary
- Manage XCAP documents pres-rules, resource-lists, rls-services and
pidf-manipulation
- Setup up ad-hoc multi-party chat sessions with an MSRP chat server (under
construction)
For testing, you can use your own infrastructure or register a free SIP
SIMPLE account on http://SIP2SIP.info
License
-------
This software is licensed according to the GNU General Public License. See
LICENSE file for more details.
Installation
------------
See docs/INSTALL.* files
Testing the software
--------------------
See the README.txt file and the executables in the scripts directory.

File Metadata

Mime Type
text/plain
Expires
Sat, Dec 28, 3:48 PM (1 d, 3 h)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
3454316
Default Alt Text
README (3 KB)

Event Timeline