source/proj/sadba/index.rst

   1
   2 =============================================
   3 Status Area Display Blanking Applet for Maemo
   4 =============================================
   5
   6
   7 Description
   8 ===========
   9
  10 The **Status Area Display Blanking Applet** (*SADBA* for short) is a simple
  11 plugin for Maemo_\ 's Hildon_ status area to control display blanking.
  12
  13 This applet let you easily change the display blanking mode right from the
  14 status menu, without having to go through the settings. It also let you
  15 inhibit display blanking without changing the mode, either until you manually
  16 disable it or using an user provided time to automatically disable the display
  17 blanking inhibition.
  18
  19
  20
  21 Screeshots
  22 ==========
  23
  24 This is how the applet looks like (the applet is highlighted by making
  25 everything else black and white and blury).
  26
  27 .. figure:: files/latest/screenshot-1.mini.png
  28    :target: files/latest/screenshot-1.png
  29    :align: center
  30
  31    Applet in the status menu, the first icon is to select the display blanking
  32    mode, the second is to manually inhibit display blanking and the third is
  33    to inhibit screen blanking just for an user specified amount of time
  34    (currently active in this screenshot).
  35
  36 .. figure:: files/latest/screenshot-2.mini.png
  37    :target: files/latest/screenshot-2.png
  38    :align: center
  39
  40    Display blanking mode selection dialog.
  41
  42 .. figure:: files/latest/screenshot-3.mini.png
  43    :target: files/latest/screenshot-3.png
  44    :align: center
  45
  46    Time selection dialog for timed inhibition feature.
  47
  48 .. figure:: files/latest/screenshot-4.mini.png
  49    :target: files/latest/screenshot-4.png
  50    :align: center
  51
  52    Detail of minutes selection for timed inhibition feature.
  53
  54 .. figure:: files/latest/screenshot-5.mini.png
  55    :target: files/latest/screenshot-5.png
  56    :align: center
  57
  58    Status area icon indicating display blanking inhibition is enabled.
  59
  60
  61
  62 Compiling/Installing
  63 ====================
  64
  65 If you just want to install the package in your phone, you probably want to do
  66 it using Hildon Application Manager (or HAM_ for short) now that the package
  67 is included in Extras_\ -\ devel__.
  68
  69 __ http://wiki.maemo.org/Extras#Extras-devel
  70
  71 If for some reason that's not good enough (maybe you don't want to add the
  72 extras-devel repository), you can install it manually getting
  73 the binaries or sources from Maemo_\ 's `package home`__. If that's not good
  74 enough either, you can find the latest source and the binary packages for
  75 Fremantle_ (tested only in a Nokia_ N900_) here__.
  76
  77 __ http://maemo.org/packages/view/status-area-displayblanking-applet/
  78 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/latest/
  79
  80 If you want to compile it yourself, you probably need to `install a scratchbox
  81 and Maemo 5 SDK`__ but, unless you're a developer wanting to improve it (and
  82 if you are you're are very welcome!), you won't need to do it.
  83
  84 __ http://www.developer.nokia.com/Community/Wiki/Maemo_5_SDK_installation_for_beginners
  85
  86 As soon as the package get uploaded to Extras_, you will be able to install it
  87 using the .
  88
  89
  90
  91 News
  92 ====
  93
  94 If you want to keep up with the updates, I usually post new releases in `my
  95 blog`__. You can subscribe__ to the `sadba tag`__ feed if you want to receive
  96 any news (or random thoughts related to this applet) or to both `sadba
  97 + release tags`__ if you only want to `subscribe to new releases`__ only.
  98
  99 __ https://llucax.com.ar/blog/
 100 __ https://llucax.com.ar/blog/blog/atom?tag=sadba
 101 __ https://llucax.com.ar/blog/blog/tag/sadba
 102 __ https://llucax.com.ar/blog/?tag=sadba&tag=release
 103 __ https://llucax.com.ar/blog/blog/atom?tag=sadba&tag=release
 104
 105
 106
 107 Discussion
 108 ==========
 109
 110 There is a thread__ in `Maemo's Community Forums`__ where I usually
 111 communicate news too. You can use it to leave comments or suggestions, report
 112 bugs or discuss whatever you want related to this applet.
 113
 114 __ http://talk.maemo.org/showthread.php?t=85514
 115 __ http://talk.maemo.org/
 116
 117
 118
 119 Repository
 120 ===========
 121
 122 This project is also hosted in a Git_ repository, if you want keep a closer
 123 look at the development (or send patches!) you can clone `my repository`__.
 124
 125 __ https://git.llucax.com.ar/w/software/sadba.git
 126
 127
 128
 129 Release History
 130 ===============
 131
 132
 133 2012-08-05
 134    Version `1.0`__ released (`release notes`__).
 135
 136    * Start display blanking inhibition immediately when activated instead of
 137      doing so when the timer for display blanking fire. This makes the applet
 138      behave properly for phones configured to blank in less than 30 seconds.
 139    * Fix build and source dependencies.
 140    * Add homepage to control file.
 141    * Strip binaries.
 142    * Optify package to use less rootfs space.
 143
 144    At Maemo_ \'s package index: armel__, i386__.
 145
 146 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/1.0/
 147 __ https://www.llucax.com.ar/blog/blog/post/7719476e
 148 __ http://maemo.org/packages/package_instance/view/fremantle_extras-devel_free_armel/status-area-displayblanking-applet/1.0/
 149 __ http://maemo.org/packages/package_instance/view/fremantle_extras-devel_free_i386/status-area-displayblanking-applet/1.0/
 150
 151
 152 2012-07-31
 153    Version `0.9`__ released (`release notes`__).
 154
 155    * Show a status icon when display blanking is inhibited.
 156    * Improve package description and add icon for the Application Manager.
 157    * Add a extended description for display blanking modes.
 158    * Update translation files.
 159    * Code cleanup.
 160
 161 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/0.9/
 162 __ https://www.llucax.com.ar/blog/blog/post/-57b1df23
 163
 164
 165 2012-07-29
 166    Version `0.5`__ released (`release notes`__).
 167
 168    * Add timed display blanking inhibition button (the user can input a timeout
 169      after which display blanking inhibition will be disabled automatically).
 170    * Do some more code cleanup.
 171
 172 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/0.5/
 173 __ https://www.llucax.com.ar/blog/blog/post/4f5bd2de
 174
 175
 176 2012-07-27
 177    Version `0.4`__ released (`release notes`__).
 178
 179    * Add display blanking inhibition button.
 180
 181 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/0.4/
 182 __ https://www.llucax.com.ar/blog/blog/post/-3f8c6e1c
 183
 184
 185 2012-07-26
 186    Version `0.3`__ released (`release notes`__).
 187
 188    * Use a dialog to let the user pick the desired blanking mode instead of
 189      cycling through all available modes.
 190
 191 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/0.3/
 192 __ https://www.llucax.com.ar/blog/blog/post/-2bb84c95
 193
 194
 195 2012-07-23
 196    Version `0.2`__ released (`release notes`__).
 197
 198    * Subscribe to GConf notifications for changes in blanking mode.
 199    * Code cleanup.
 200
 201 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/0.2/
 202 __ https://www.llucax.com.ar/blog/blog/post/106cdb32
 203
 204
 205 2012-07-10
 206    Version `0.1`__ released (`release notes`__).
 207
 208    * Initial release.
 209
 210 __ https://www.llucax.com.ar.nyud.net/proj/sadba/files/0.1/
 211 __ https://www.llucax.com.ar/blog/blog/post/-30fd5e24
 212
 213
 214
 215 .. _Maemo: http://www.maemo.org/
 216 .. _Hildon: http://wiki.maemo.org/Hildon
 217 .. _Fremantle: http://wiki.maemo.org/Maemo5_101
 218 .. _Nokia: http://en.wikipedia.org/wiki/Nokia
 219 .. _N900: http://en.wikipedia.org/wiki/Nokia_N900
 220 .. _Extras: http://wiki.maemo.org/Extras
 221 .. _HAM: http://hildon-app-mgr.garage.maemo.org/
 222 .. _Git: http://git-scm.com/
 223
 224
 225 .. vim: set et sw=3 sts=3 tw=78 :