QtLockscreen

2011-08-19T17:20:21Z

87.157.58.245: /* Customization */

== General Information ==

QtLockscreen is a highly configurable replacement of Maemo5 default lockscreen created by [http://talk.maemo.org/member.php?u=49449 "sakya"].
(Credits for the backend go to [http://talk.maemo.org/member.php?u=25578 "MohammadAG"])

Further information and discussions can be found here:

* [http://talk.maemo.org/showthread.php?t=75150 "(Announce) QtLockscreen: highly configurable lockscreen replacement"]
* [http://talk.maemo.org/showthread.php?t=75187 "Share your QtLockscreen configs!"]
* [http://www.assembla.com/spaces/qtlockscreen/wiki "Project Page"]

For further support and information you might want to check these threads.

Check the following links to get an impression of how OtLockscreen looks:

* [http://www.assembla.com/spaces/qtlockscreen/documents/a28hxKTfyr4lm5eJe4gwI3/download/a28hxKTfyr4lm5eJe4gwI3 "Screenshot"],

* [http://www.youtube.com/watch?v=hUK7OvJZGdo "video"] (Created by [http://talk.maemo.org/member.php?u=30235 "F2thaK"]) and

* [http://www.youtube.com/watch?v=Jm2jdI0Op8Q "video"] (Created by [http://talk.maemo.org/member.php?u=48195 "pusak gaoq"])

Currently this app is available from extras-devel (See [http://maemo.org/packages/view/qtlockscreen/ Package Info Page]).

== Disclaimer ==

'''!!! CAUTION !!!'''

Default extras-devel disclaimer:
This project is still in development stage, which means there might still be some risks, downsides and issues to be solved before it is ready for the average user...
Please read this summary carefully and evaluate the risks involved for yourself!
(Keep in mind that this can cause problems for the phone. Backup your data, backup your config (apps > system > backup) and know how to reflash)

'''Whatever you do, you are doing it at your own risk!'''

== Change Log ==

===''' Version 0.1.0 '''===

* Initial Release

===''' Version 0.1.1 '''===

* Changed default background to /etc/hildon/theme/backgrounds/lockslider.png
* Changed font settings, format = "fontName;fontSize;fontWeight;italic"

===''' Version 0.1.2 '''===

* Fixed _HILDON_WM_ACTION_NO_TRANSITIONS

===''' Version 0.1.3 '''===

* Added italian translation
* Added french translation (GaRy delaMEr)
* Added PercentageColor setting for battery widget
* Fixed: the lockscreen was on top of the alarm dialog
* Fixed: battery widget now has a ChargingImage setting

===''' Version 0.1.4 '''===

* Added german translation (NightShift79)
* The default config file is always copied to /home/user/.config/sakya/QtLockscreen.ini.default
* Added postrm script
* Fixed metadata update

===''' Version 0.1.5 '''===

* Added SlideToUnlock widget
* Added languages: cn_CN, tw_TW
* Added setting to set the text for notification widget
* Added setting to set the text position for notification widget
* Added IM notification
* Added Text widget
* Removed embedded resources: all resources are copied to /opt/qtlockscreen

===''' Version 0.1.6 '''===

* Fixed background problem when Orientation is set to "portrait"
* Added to SlideToUnlock settings UnlockXL, UnlockXP, UnlockYL, UnlockYP

===''' Version 0.1.7 '''===

* Fixed background problem when Orientation is set to "portrait" (really) :)

===''' Version 0.1.8 '''===

* Added setting to override the system locale (see the default config file)
* Added wifi widget
* Added Weather widget
* Fixed albumart corrupted if the widget has different size in portrait and landscape
* Added languages: sv_SV
* Fixed: reverted to old orientation manager (it should fix the problems appeared from version 0.1.5)

===''' Version 0.1.9 '''===

* Fixed Weather widget script
* Fixed languages: sv_SV (I forgot the file in v.0.1.8)

== Known Issues ==

* When the power button is clicked the app does not update the screen for 2 seconds. This seems a Qt problem: every qt application "locks" when the power button is pressed, I don't know why.
* The rotation is slow.
* Album art is not loaded correctly in some situations

== Requested Features ==

* GUI for configuration (sakya is currently not planning to create a GUI, maybe someone is willing to help out here ;-) )
* Clicking on the notifications directly opens the related app. i.e. sms' opens the conversation app, missed calls opens the phone app
* Configuring the length of time the lockscreen stays before fading out

== Planned Features ==

* <s>Swipe to unlock widget / feature</s> (Implemented in v0.1.5)
* <s>IM notification widget</s> (Implemented in v0.1.5)
* Operator widget
* <s>Wifi/3g widget</s> (Implemented in v0.1.8)
* <s>Weather widget</s> (Implemented in v0.1.8)
* Signal widget
* Change profile (general / silent) widget

== Widget list ==

<pre>
Rect:
Color rectangle bkg color
Radius border radius

DateTime:
Alignment text alignment
TimeColor color of time text
DateColor color of date text
DateFormat date format
TimeFormat time format
TimeFont font for time text
DateFont font for date text

Battery:
Images list of images (separated by ;) to represent the battery charge
ChargingImage image to use when the battery is charging
PercentageColor color for percentage
PercentageFont font for percentage

UnlockButton:
WaitTimeMsec time to keep the button press before the unlock (in ms)
BackGroundImage button bkg image
BackGroundImagePressed button bkg when is pressed

SlideToUnlockButton:
SliderPos initial slider position (relative to the widget)
SliderImage image for the slider
BackgroundImage widget background image
UnlockXP unlock x position (portrait)
UnlockYP unlock y position (portrait)
UnlockXL unlock x position (landscape)
UnlockYL unlock y position (landscape)

MediaPlayPauseButton:
BackGroundImagePause bkg image for pause
BackGroundImagePausePressed bkg image for pause when is pressed
BackGroundImagePlay bkg image for play
BackGroundImagePlayPressed bkg image for play when is pressed

MediaNextButton:
BackGroundImage bkg image
BackGroundImagePressed bkg image when is pressed

MediaBackButton:
BackGroundImage bkg image
BackGroundImagePressed bkg image when is pressed

MediaMetadata:
Alignment text alignment
TitleColor color for title text
ArtistColor color for artist
TitleFont color for title
ArtistFont color for artist

MediaAlbumArt:
NoCoverImage image to use when no cover is available

MediaTimeLabel:
Color color for text
Font font for text

Image:
Alpha alpha (0-255) for the image
Image image

Notification:
Type notification type (call, sms, email, im)
TextAlignment text alignment relative to the image (top, bottom, left, right)
Color text color
Font text font

Text:
Alignment text alignment
Color text color
Font text font
Text text

Weather:
AutoUpdateIntervalSeconds seconds between each auto update
CurrentText text to use before the current temp
CurrentPos position of the current temp text (relative to this widget)
CurrentFont color for the current temp
CurrentColor color for the current temp
HighText text to use before the high temp
HighPos position of the high temp text (relative to this widget)
HighFont color for the high temp
HighColor color for the high temp
LowText text to use before the current temp
LowPos position of the current temp text (relative to this widget)
LowFont color for the current temp
LowColor color for the current temp
MinimumSecondsBetweenUpdates minimum time between each update
Link yahoo weather link (without http://weather.yahoo.com/) ex: italy/lombardy/milan-718345
Unit unit to use (c or nothing)

Wifi:
Image image
</pre>

== Customization ==

Every item on the screen is configurable (position, size, font, image...).
You can also remove or add items.

!!!Note:
Items are called widget in this context.
But these aren't Maemo desktop widgets.
You can't add a desktop widget to this lockscreen.
"Widgets" are coded specifically for the lockscreen, you can use only the widgets provided by the app (rectangle, metadata, datetime....)
Widgets are drawn in the order they are created, the last is the topmost.

In order to customize QtLocscreen you need to edit the default configuration
(it is automatically created in /home/user/.config/sakya/QtLockscreen.ini the first time the app is launched) '''as root''':

'''Just some hints for better theme quality and easier management:'''

'/opt/qtlockscreen/default/' is the default theme folder and should not be used to store your custom images or other files, so you should not overwrite or add / delete anything here. It is advised to create a directory that is named as your theme in directory '/opt/qtlockscreen/' and put everything there.

The configuration file has a section for the theme name:
<pre>ThemeName="Default"</pre>
Adapt this to reflect the theme namechange internally; so use the value from '<yourthemename>' here.

Place your customized QtLockscreen.ini in /opt/qtlockscreen/<yourthemename> too, and simply symlink it to '/home/user/.config/sakya/QtLockscreen.ini' by issuing this command:

<pre>ln -s /opt/qtlockscreen/<yourthemename>QtLockscreen.ini /home/user/.config/sakya/QtLockscreen.ini</pre>

Doing so, you would not have to overwrite settings every time; this enables simple theme switching for now.

As for the backgrounds like all other customized images, it is suggested to include them in /opt/qtlockscreen/<yourthemename> as 'backgroundL.(jpg|png)' for landscape orientation and 'backgroundP.(jpg|png)' for portrait orientation.

As the major result of taking such precautions your QtLockscreen theme is basically self-contained, and can be more easily distributed to other users. Another positive point is it will not place used theme backgrounds / icons that are not true desktop backgrounds in '/home/user/MyDocs/.images' or other file system directories too, keeping everything tidy.

NOTE: the default configuration file that contains all widgets and is updated if you install a new release from the repository can be found here:
<pre>/home/user/.config/sakya/QtLockscreen.ini.default</pre>

If you change the configuration file you need to kill the lockscreen process (or reboot).

To kill the lockscreen, type
<pre>pkill -HUP qtlockscreen</pre>

in Xterm and hit enter.

=== Customizing time format ===

Change
<pre>TimeFormat="hh:mm"</pre>

to, if you want AM/PM
<pre>TimeFormat="hh:mm AP"</pre>

or, if you want am/pm
<pre>TimeFormat="hh:mm ap"</pre>

=== Customizing icons ===

Icon can be any size.
The icon will be center/top aligned in the size you give to the widget, the text will be horizontally centered just under the icon.
Just be sure that the Size you set is enough to display the icon and the text.
To change the notifications icon you should change the
<pre>Icon=":/images/message.png"</pre>

The ":/" refers to the project resources, you have to use a "normal" path "/home/user/..."

=== Positioning items ===

You need to define the numbers of pixels, but you can also do "center; center" (for example) to get the object perfectly centered

=== Reset to the default configuration ===

Open a terminal and

<pre>sudo gainroot
rm .config/sakya/QtLockscreen.ini
pkill -HUP qtlockscreen</pre>

== Available Customizations ==

Please share your customized lockscreens here!!!

=== 1) Created by [http://talk.maemo.org/member.php?u=30235 "F2thaK"] ===

Short description:
-no media/email widgets
-black battery font
-big time/date/battery/unlock
-slide to unlock
-12hr time with no preceding zero
-compatible with v0.1.7

SCREENS/DOWNLOAD: http://talk.maemo.org/showpost.php?p=1068392&postcount=197
Video: http://www.youtube.com/watch?v=b9QWb2X6F30

=== 2) Created by [http://talk.maemo.org/member.php?u=28950 "qw3rty"] ===

Short description: Big next track button

Screenshot: [http://img20.imageshack.us/img20/7830/screenshot2011072221372.png "Landscape"] [http://img51.imageshack.us/img51/9591/screenshot2011072221371.png "portrait"]

Config.ini: n/a

=== 3) Created by [http://talk.maemo.org/member.php?u=51399 "Hurrian"] ===

Short description: Big time, time and date left, media widget whole width. Supports landscape and portrait modes.

Screenshot: Current version: [http://goput.it/4w5.png "Landscape"]

QtLockscreen.ini: [http://goput.it/str/zey.zip "Not a real zip, rename it to QtLockscreen.ini"]

Images: [http://goput.it/str/sae.tar "link"]

=== 4) Created by [http://talk.maemo.org/member.php?u=46309 "Syndrome"] ===

Short description: No media player, custom wallpaper

Screenshot: [http://dl.dropbox.com/u/5361213/Screenshot-20110723-144828.png "Landscape"]

Config.ini: n/a

=== 5) Created by [http://talk.maemo.org/member.php?u=45961 "kishanW"] ===

Short description: Biiiig time (12hr format)

Screenshot: [http://www.atox-d.com/testGround/tempUploads/n900_qtLockscreen/Screenshot-20110724-024121.png "Portrait"]

Config.ini: [http://www.atox-d.com/testGround/tempUploads/n900_qtLockscreen/qtlockscreenconfig.txt "link"]

Wallpaper: [http://www.atox-d.com/testGround/tempUploads/n900_qtLockscreen/wallpaper-1064497P.jpg "Portrait"], [http://www.atox-d.com/testGround/tempUploads/n900_qtLockscreen/wallpaper-1064497L.jpg "Landscape"]

=== 6) Created by [http://talk.maemo.org/member.php?u=28950 "qw3rty"] ===

Short description: Very music player centric, larger album cover and buttons. Play/pause by tapping the cover.

Screenshot: [http://img215.imageshack.us/img215/5483/screenshot2011072317200.png "Landscape"] [http://img692.imageshack.us/img692/2637/screenshot2011072317202vo.png "portrait"]

Config.ini: [http://talk.maemo.org/showpost.php?p=1056964&postcount=2 "link"]

=== 7) Created by [http://talk.maemo.org/member.php?u=27553 "lingling92"] ===

Short description: Big time, date and media player, notifications only in portrait mode

Screenshot: [http://talk.maemo.org/attachment.php?attachmentid=21599&stc=1&d=1311445072 "Landscape"] [http://talk.maemo.org/attachment.php?attachmentid=21600&stc=1&d=1311445084 "portrait"]

Config.ini: [http://talk.maemo.org/attachment.php?attachmentid=21601&d=1311445147 "link"]

=== 8) Created by [http://talk.maemo.org/member.php?u=38353 "Zekahz"] ===

Short description: Only portrait mode edited, big time, no top bar. The space above the time and date is one giant invisible media player next-button

Screenshot: [http://goput.it/8lo.png "portrait"]

Config.ini: [http://talk.maemo.org/attachment.php?attachmentid=21608&d=1311497738 "link"]

=== 9) Created by [http://talk.maemo.org/member.php?u=48195 "pusak gaoq"] ===

Short description: Centered

Screenshot: [http://img97.imageshack.us/img97/9418/screenshot2011072410314.png "landscape"] [http://img847.imageshack.us/img847/1477/screenshot2011072410315.png "portrait"]

Config.ini: n/a

Video: [http://www.youtube.com/watch?v=Jm2jdI0Op8Q "link"]

=== 10) Created by [http://talk.maemo.org/member.php?u=42195 "KingKobraone"] ===

Short description: MeeGo.de, notifications top, media player bottom, battery left

Screenshot: [http://meego.de/media/kunena/attachments/3559/Screenshot-20110724-163306.png "landscape"] [http://meego.de/media/kunena/attachments/3559/Screenshot-20110724-163334.png "portrait"]

Config.ini, lockscreens and font: [http://talk.maemo.org/attachment.php?attachmentid=21615&d=1311521567 "link"]

(add lockscreens to "/etc/hildon/theme/backgrounds/", load font with Theme customizer you dont need to activate it, the font only will be used in lockscreen)

=== 11) Created by [http://www.forums.internettablettalk.com/member.php?u=47181 "ammyt"] ===

1. Hair-comb:

Short description: Android Honeycomb 3 lockscreen skin, 12 hr AM/PM Android clock, Android date, glow ripple circles on lock, simplistic no media player.

Screenshot: [http://www.imagehousing.com/image/810250 "portrait"] [http://www.imagehousing.com/image/810249 "landscape"]

Config script + instructions: [http://www.forums.internettablettalk.com/showpost.php?p=1058352&postcount=73 Post]

2. Black Crystal (unfinished):

Short description: Big urban-styled clock and date, htc sense panel, black/green color combination, glowing battery gauge, portrait only till now.

Screenshot: [http://www.imagehousing.com/image/812904 "portrait"]

Config script + instructions: [http://talk.maemo.org/showpost.php?p=1060248&postcount=138 Post]

3. Elegy:

Short description: Elegant clock and date fonts, elegant music player centered, play/pause by tapping album art, Android panel, elegant glowing battery gauge, portrait mode.

Screenshot: [http://i.imgur.com/ayagP.png "portraits]

Config script + instructions: [http://talk.maemo.org/showpost.php?p=1060692&postcount=147 Post]

4. Neon:

Short description: Cool-looking blue dotted LED circular station, media player, play/pause by tapping albim art, blue-dotted clock and date, portrait mode.

Screenshot: [http://i.imgur.com/RvN89.png "portrait"]

Config script + instructions: [http://talk.maemo.org/showpost.php?p=1061798&postcount=4098 Post]

=== 12) Created by [http://talk.maemo.org/member.php?u=41707 "Harick"] ===

1. Danael M9 MBEx:

Short description: IOS iphone4 theme customized by Danael [http://jdanael.deviantart.com/art/Danael-M9-MBEx-Theme-185243175 "M9 MBEx"]. media player without album art, clock, date and day

Type: Tap to unlock

Screenshot: [http://i51.tinypic.com/4kcnfd.png "portrait"] [http://i52.tinypic.com/2nvx8gj.png "landscape"]

Instructions: [http://talk.maemo.org/showpost.php?p=1057627&postcount=453 Post]

2. Marina v1:

Short description: Marina-like lockscreen, simple, clock and date + batery meter. notifications availables only for Missed calls, Sms and Emails

Type: Tap to unlock

Screenshot: [http://i56.tinypic.com/s5jtw3.png "portrait"] [http://i54.tinypic.com/2ius3g8.png "landscape"]

Instructions: [http://talk.maemo.org/showpost.php?p=1059024&postcount=103 Post]

3. Marina v2 + Mediaplayer:

Short description: Marina-like lockscreen, simple, clock and date + batery meter. All notifications availables (Missed calls, SMS, IM and Emails). Media player with Album art.

Type: Tap to unlock

Screenshot: [http://i53.tinypic.com/316qnmp.png "portrait"] [http://i51.tinypic.com/2h5mlpx.png "landscape"]

Instructions: [http://talk.maemo.org/showpost.php?p=1059585&postcount=131 Post]

4. Killik Mediaplayer Lockscreen:

Short description: portrait only, "mediaplayer" lockscreen, showing song info, album art, controls, battery state, clock and notifications.

Type: Tap to unlock

Screenshot: [http://i53.tinypic.com/2rvyec0.png "normal"] [http://i52.tinypic.com/v2xrts.png "charging"]

Instructions: [http://talk.maemo.org/showpost.php?p=1061344&postcount=167 Post]

3. R2D2:

Short description: Simple gray minimal lockscreen, clock and date + batery meter. All notifications availables (Missed calls, SMS, IM and Emails).
custom background, .psd and font included

Type: Slide to unlock

Screenshot: [http://i55.tinypic.com/eafq6q.png "portrait"] [http://i54.tinypic.com/4qpsep.png "landscape"]

Instructions: [http://talk.maemo.org/showpost.php?p=1069510&postcount=223 Post]

=== 13) Created by [http://talk.maemo.org/member.php?u=50952 "Laith.M.Y"] ===

1- Sense :

Short description: HTC Sense 3.0 style lockscreen,contains clock,date,media player and notifications . The notifications that availables are Missed calls and SMS only.

Type : Tap to unlock (you must tap on the TIME)

Screenshot: [http://img838.imageshack.us/img838/8939/screenshot2011080518403.png "Portrait only"]

Instructions: [http://talk.maemo.org/showpost.php?p=1064710&postcount=184 "Post"]

2- IPhone :

Short description: iphone style lockscreen,contains clock,date,battery,mediaplayer and notifications . All notifications availables (Missed calls,SMS,IM and Email).You can change the background as you want because the backgrounds of time and slider are transparent.
3 backgrounds available (default iphone background , Clown fish , Fresh series)

Type : Slide to unlock

Screenshots: with MP widget [http://img819.imageshack.us/img819/5779/screenshot2011081815212.png "Portrait"] , [http://img716.imageshack.us/img716/9258/screenshot2011081816105.png "Landscape"]
, without MP widget [http://img600.imageshack.us/img600/3701/screenshot2011081822571.png "Portrait"] , [http://img148.imageshack.us/img148/8516/screenshot2011081822564.png "Landscape"]

Instructions : [http://talk.maemo.org/showpost.php?p=1072337&postcount=299 "Post"]

=== 14) Created by [http://talk.maemo.org/member.php?u=47919 "Robin92"] ===

1-
Htc sense with unlock down
 
No mediaplayer
 
Only portrait mode:)
[http://imageshack.us/photo/my-images/143/screenshot2011081511494.png/ "Htc lockscreen picture"]

Here is the files: http://talk.maemo.org/showpost.php?p=1070125&postcount=253

=== 15) Created by [http://talk.maemo.org/member.php?u=34266 "DJQwamii"] ===

Short description: 
- Slide to Unlock 
- Different Slide-to-Unlock Directions for Portrait & Landscape 
- Contains notifications for missed calls, sms, IMs and emails (beta) 
- '''No media player''' 
 
Screenshots & Download: [http://talk.maemo.org/showpost.php?p=1072727&postcount=309 "http://talk.maemo.org/showpost.php?p=1072727&postcount=309"]

== Donations ==

...are welcome: [https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=M7C9G49XRH7WL "donate"]

[[Category:Software]]
[[Category:Fremantle]]

Maemo Wiki Mirror - User contributions [en]

QtLockscreen