# adesklets 0.6.1

## Table of Contents

- adesklets
- 1 What is adesklets?
  - 1.1 Short answer
  - 1.2 Long answer
- 2 What's new?
- 3 Installing adesklets
  - 3.1 Compilation Requirements
  - 3.2 Runtime requirements
  - 3.3 Portability Notice
  - 3.4 Software download
  - 3.5 Verifying Software Integrity (optional)
  - 3.6 Compilation and Installation:
  - 3.7 Compilers and Options:
  - 3.8 Optional Features:
- 4 Using adesklets
  - 4.1 ... As a desklets container
    - 4.1.1 Add a new desklet to your X display
      - Alternative to manually downloading the desklets
      - Special notes on system fonts
      - Special notes on internationalization
    - 4.1.2 Restore previously running desklets on new X session
  - 4.2 ... As a command-line graphic editor
- 5 Programming adesklets
  - 5.1 An adesklets' primer
  - 5.2 Real programming with adesklets: writing desklet scripts
    - 5.2.1 General tips for programmers
    - 5.2.2 adesklets and Python
      - Python usage example
      - Gotchas: a bit more about object IDs
      - Special subject: animations
      - Configuration and internationalization
      - Final words
    - 5.2.3 adesklets and Perl
      - Perl usage example
      - Catching errors
      - Configuration
      - Final words
- 6 Using adesklets from other language environments
  - 6.1 Requirements
  - 6.2 Initialization mechanism
    - 6.2.1 adesklets called as a desklets launcher - restarting all desklets
    - 6.2.2 adesklets called as an interpreter - registration of a new desklet
    - 6.2.3 Consequences
  - 6.3 Using streams
    - 6.3.1 stdin: the commands
    - 6.3.2 stdout: the command results
    - 6.3.3 stderr: the events
  - 6.4 SIGCHLD signal handler
  - 6.5 Textual variables
  - 6.6 Final words
- 7 Contributing to adesklets
- Appendix A Frequently asked questions
  - A.1 Compiling adesklets
  - A.2 Installing desklets
  - A.3 Starting and stopping desklets
  - A.4 Displaying desklets
  - A.5 Running desklets
- Appendix B Python package documentation
- Appendix C Perl package documentation
- Appendix D Imlib2 documentation
- Appendix E Packaging GNU Makefile for desklets
- Appendix F Submitting a desklet
  - F.1 Desklet package requirements
  - F.2 The `adesklets_submit` script
  - F.3 Invoking `adesklets_submit`
    - F.3.1 Further submission validation using `adesklets_checkin`
    - F.3.2 Limitations of `adesklets_checkin` in non-interactive mode
- Appendix G Copying This Manual
  - G.1 GNU General Public License
- Appendix H Open PGP Public Key

Next: About adesklets, Up: (dir)

## adesklets

[French version]

This manual is for adesklets (version 0.6.1, 30 March 2006).

Copyright © 2004, 2005, 2006 Sylvain Fourmanoit syfou@users.sourceforge.net.

Various corrections and updates by Mike Pirnat exilejedi@users.sourceforge.net.

> Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation. A copy of the license is included in the appendix entitled “Copying This Manual”.

The latest version of this document can be found online at http://adesklets.sf.net/doc/en/.

Screenshots, source tarballs, downloadable web documentation tarballs, etc. can also be found on the project home page: http://sf.net/projects/adesklets/.