Net::DBus::Skype - Perl access to Skype's DBus API


This module supplies a perl API into Skype via DBus. It was inspired by the discussion at, and adapted from Philipp Kolmann's code base. Nothing much of Philipps code remains other than his choice of error messagses.

If what your doing isn't specific to Skype, use the non proprietary "callto" protocol in your code! Example, href="callto:8325555555"


        use Net::DBus::Skype;

        my $s = Net::DBus::Skype->new;
        my $s = Net::DBus::Skype->new({ debug => 1 });

        # -or-
        # -or-
        # -or-
        $s->raw_skype('CALL echo123');


This module also installs two scripts, skype-action-handler, and skype-simple-dialer. The first script, skype-action-handler, takes Skype action uris on the command line and simply creates an instance and feeds them to ->action. The second script, skype-simple-dialer, takes a phone number, and simply feeds it to the ->raw_skype CALL. The skype-action-handler script should be fully compatable with the C program by the same name that once was distributed with Skype.



Takes a skype pseudo-uri, or pseudo-url, ex. skype://echo123?call. This is parsed into three components: protocol, user, and command. Valid options for protocol are "skype", "callto", and "tel". It is then translated into raw_skype and sent off through the DBus communication link. The default command is call.


Issuess raw_skype commands exposed through the DBus API. An example of this command would be, "CALL echo123".


Evan Carroll, <me at>


Please report any bugs or feature requests to bug-net-dbus-skype at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


You can find documentation for this module with the perldoc command.

perldoc Net::DBus::Skype

You can also look for information at:



Copyright 2008 Evan Carroll, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.