Description

Twinkle sip client, ported to a python module.

Tested environments

Instalation

sudo apt-get install twinkle
sudo pip3 install pytwinkle

Example

from pytwinkle import Twinkle
def callback(event, *args):
    if event=="registration_succeeded":
        uri, expires = args
        print("registratiom succeeded, uri: %s, expires in %s seconds"%(uri, expires))
        # The module keeps the session, you havent to register
        mTP.message("name@domain", "Hello")
        mTP.call("name@domain")
    if event=="new_msg":
        msg=args[0]
        print("new_msg!: "+str(msg))
    if event=="incoming_call":
        call=args[0]
        print("call: "+str(call))
    if event=="cancelled_call":
        line=args[0]
        print("call cancelled, line: %s"%(line))
    if event=="failed_call":
        line=args[0]
        print("failed_call, line: %s"%(line))
    if event=="dtmf_received":
        line=args[0]
        key=args[0]
        print("dtmf_received, line: %s, key: %s"%(key))
    if event=="answered_call":
        call=args[0]
        print("answered: %s"%(str(call)))
    if event=="ended_call":
        line=args[0]
        print("call ended, line: %s"%(line))
mTP = Twinkle(callback)  
mTP.set_account("name","domain","password")
mTP.run()

• Callbacks

(*) doesnt matter the seconds to expire, the program keep the session active

• Functions

  • call Call someone
  • answer Answer an incoming call
  • answerbye Answer an incoming call or end a call
  • reject Reject an incoming call
  • bye End a call
  • hold Put a call on-hold
  • retrieve Retrieve a held call
  • redial Repeat last call
  • register Register your phone at a registrar
  • deregister De-register your phone at a registrar
  • message Send an instant message

• Not supported at the moment

  • redirect Redirect an incoming call
  • transfer Transfer a standing call
  • conference Join 2 calls in a 3-way conference
  • mute Mute a line
  • dtmf Send DTMF
  • fetch_reg Fetch registrations from registrar
  • options Get capabilities of another SIP endpoint
  • line Toggle between phone lines
  • dnd Do not disturb
  • auto_answer Auto answer
  • user Show users / set active user
  • presence Publish your presence state
  • quit Quit

Dependencies

• System dependencies
  • python3
  • twinkle
• Python dependencies
  • multiprocessing

Mentions

@LubosD - https://github.com/LubosD/twinkle

Developer

Roberto Lama Rodríguez - roberlama@gmail.com