pyinbox for Python for S60

Mon Apr 25 05:23:22 2011


  1. Introduction
  2. Status
  3. Examples
  4. License
  5. Download
  6. Dependencies
  7. Acknowledgements

1. Introduction

The pyinbox extension is a renamed and slightly tweaked version of the inbox module of Python for S60. The sole motivation for creating a modified version was to make it possible to access "Bluetooth" messages (i.e., Bluetooth OBEX pushed messages) in the phone Inbox, which at the time of writing is not possible with the inbox module as released by Nokia. The changes introduced by pyinbox are a bit of an ugly hack, but they serve their purpose.

Only PyS60 1.4.x series is supported by this extension.

2. Status

The PyS60 inbox on which this software is based is used widely, but this variant is a different story. It has, however, been found to be stable for the purpose of accessing OBEX Bluetooth messages in the Inbox.

3. Examples

The programs used to test pyinbox also serve as example programs. There is API documentation available for the original inbox module, but not for pyinbox. Hopefully the example programs are sufficient for pointing out the API differences, but one can always resort to reading the source code.

4. License

For the license under which the software is released, see the license.txt file.

5. Download

A collection of release builds is available. The self variant is self-signed, with maximum self-signable capabilities. The dev variant is signable with Symbian's Open Signed Online or with a developer certificate, and has maximum capabilities allowed by Open Signed Online.

You may or may not find the changelog useful in trying to determine what has changed between releases.

A Git repository of the source code (with change history) is also available, hosted on GitHub at http://github.com/contextlogger/pyinbox.

6. Dependencies

The software should run on pretty much any S60 device, long as one installs the correct build variant, albeit there may be some differences in functionality depending on the variant. The software depends on the Python for S60 runtime. Does not depend on non-public APIs or anything exotic.

7. Acknowledgements

The library was created at HIIT.


Tero Hasu