== 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

== 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''':

<pre>[Main]
#This is the configuration file for QtLockscreen.
#Here you can customize the look of the lockscreen.
#
#Some notes on settings:
# -Fonts: to set a font use a string composed with:
# "fontName;fontSize;fontWeight;italic"
# If fontName is empty it will be used the default system font.
# For italic use 1 to enable it.
# For fontWeight use one of the following value: light, normal, demibold, bold, black
# Example:
# Font=";14;normal;0"
#
# -Colors: to specify a color use R;G;B;A notation.
# Example:
# Color="255;255;255;255"
#
# -Position: you can set different position for portrait and landscape.
# PosL is the position in landscape
# PosP is the position in portrait
# For position you can use the special value: left, center, right, top, bottom
#
# -Size: : you can set different size for portrait and landscape.
# SizeL is the size in landscape
# SizeP is the size in portrait

#Orientation: auto, landscape, portrait
Orientation="auto"

#Path to background image for Portrait (P) and Landscape (L)
BackGroundImageP="/etc/hildon/theme/backgrounds/lockslider.png"
BackGroundImageL="/etc/hildon/theme/backgrounds/lockslider.png"

#List of widgets.
# Name is composed by WidgetType.WidgetName
# The WidgetName must be unique.
# Please respect the numeric order, don't leave "holes" in the list and set a correct Size.
# If you add/remove widget remember to update the Size at the end of the list.
# Widgets are drawn using this order: the higher number is the topmost widget
Widgets\1\Name="Rect.Rect_Bottom"
Widgets\2\Name="Rect.Rect_Top"
Widgets\3\Name="DateTime.DateTime"
Widgets\4\Name="Battery.Battery"
Widgets\5\Name="UnlockButton.UnlockButton"
Widgets\6\Name="MediaPlayPauseButton.PlayPauseButton"
Widgets\7\Name="MediaNextButton.NextButton"
Widgets\8\Name="MediaBackButton.BackButton"
Widgets\9\Name="MediaMetadata.Metadata"
Widgets\10\Name="MediaAlbumArt.AlbumArt"
Widgets\11\Name="Rect.TimeLabelBackground"
Widgets\12\Name="MediaTimeLabel.TimeLabel"
Widgets\13\Name="Notification.MissedCalls"
Widgets\14\Name="Notification.UnreadSMS"
Widgets\15\Name="Notification.UnreadEmails"
Widgets\Size=15

#Widgets
# The [Name] must match the WidgetName defined in the Widgets list
[DateTime]
Alignment="center"
PosL="center;0"
PosP="center;0"
DateFont=";12;normal;0"
DateColor="255;255;255;255"
TimeFont=";30;normal;0"
TimeColor="255;255;255;255"
TimeFormat="hh:mm"
DateFormat="dddd dd/MM/yyyy"

[Rect_Bottom]
SizeL="800;70"
PosL="0;410"
SizeP="480;70"
PosP="0;730"
Radius=0
Color="0;0;0;150"

[Rect_Top]
SizeL="800;80"
PosL="0;0"
SizeP="480;80"
PosP="0;0"
Radius=0
Color="0;0;0;150"

[Battery]
Images=":/images/battery_0.png;:/images/battery_1.png;:/images/battery_2.png;:/images/battery_3.png;:/images/battery_4.png;:/images/battery_5.png;:/images/battery_6.png"
PosL="700;15"
PosP="380;15"
PercentageFont=";8;normal;0"
PercentageColor="255;255;255;255"

[UnlockButton]
WaitTimeMsec=1000
BackGroundImage=":/images/unlock.png"
BackGroundImagePressed=":/images/unlockPressed.png"
PosL="center;410"
PosP="center;730"

[PlayPauseButton]
BackGroundImagePause=":/images/pause.png"
BackGroundImagePausePressed=":/images/pausePressed.png"
BackGroundImagePlay=":/images/play.png"
BackGroundImagePlayPressed=":/images/playPressed.png"
PosL="210;160"
PosP="210;160"

[NextButton]
BackGroundImage=":/images/forward.png"
BackGroundImagePressed=":/images/forwardPressed.png"
PosL="280;160"
PosP="280;160"

[BackButton]
BackGroundImage=":/images/back.png"
BackGroundImagePressed=":/images/backPressed.png"
PosL="140;160"
PosP="140;160"

[Metadata]
TitleFont=";20;normal;0"
TitleColor="255;255;255;255"
ArtistFont=";14;normal;0"
ArtistColor="255;255;255;255"
Alignment="left"
SizeL="400;100"
PosL="140;90"

[AlbumArt]
SizeL="120;120"
PosL="5;90"

[TimeLabelBackground]
PosL="5;190"
SizeL="50;20"
Color="0;0;0;150"
Radius=0

[TimeLabel]
PosL="5;190"
SizeL="50;20"
Font=";10;normal;0"
Color="255;255;255;255"

[MissedCalls]
Icon=":/images/call.png"
PosL="center;250"
PosP="center;360"
SizeL="160;100"
Type="call"
Font=";14;normal;0"
Color="255;255;255;255"

[UnreadSMS]
Icon=":/images/message.png"
PosL="120;250"
PosP="left;360"
SizeL="160;100"
Type="sms"
Font=";14;normal;0"
Color="255;255;255;255"

[UnreadEmails]
Icon=":/images/email.png"
PosL="520;250"
PosP="right;360"
SizeL="160;100"
Type="email"
Font=";14;normal;0"
Color="255;255;255;255"
</pre>

If you change the configuration file you need to kill the lockscreen (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 shold 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]]

QtLockscreen

2011-08-19T12:48:49Z

217.18.180.202: /* Change Log */

== 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
* Wifi/3g widget
* Weather widget
* Signal widget
* Change profile (general / silent) widget

== 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''':

<pre>[Main]
#This is the configuration file for QtLockscreen.
#Here you can customize the look of the lockscreen.
#
#Some notes on settings:
# -Fonts: to set a font use a string composed with:
# "fontName;fontSize;fontWeight;italic"
# If fontName is empty it will be used the default system font.
# For italic use 1 to enable it.
# For fontWeight use one of the following value: light, normal, demibold, bold, black
# Example:
# Font=";14;normal;0"
#
# -Colors: to specify a color use R;G;B;A notation.
# Example:
# Color="255;255;255;255"
#
# -Position: you can set different position for portrait and landscape.
# PosL is the position in landscape
# PosP is the position in portrait
# For position you can use the special value: left, center, right, top, bottom
#
# -Size: : you can set different size for portrait and landscape.
# SizeL is the size in landscape
# SizeP is the size in portrait

#Orientation: auto, landscape, portrait
Orientation="auto"

#Path to background image for Portrait (P) and Landscape (L)
BackGroundImageP="/etc/hildon/theme/backgrounds/lockslider.png"
BackGroundImageL="/etc/hildon/theme/backgrounds/lockslider.png"

#List of widgets.
# Name is composed by WidgetType.WidgetName
# The WidgetName must be unique.
# Please respect the numeric order, don't leave "holes" in the list and set a correct Size.
# If you add/remove widget remember to update the Size at the end of the list.
# Widgets are drawn using this order: the higher number is the topmost widget
Widgets\1\Name="Rect.Rect_Bottom"
Widgets\2\Name="Rect.Rect_Top"
Widgets\3\Name="DateTime.DateTime"
Widgets\4\Name="Battery.Battery"
Widgets\5\Name="UnlockButton.UnlockButton"
Widgets\6\Name="MediaPlayPauseButton.PlayPauseButton"
Widgets\7\Name="MediaNextButton.NextButton"
Widgets\8\Name="MediaBackButton.BackButton"
Widgets\9\Name="MediaMetadata.Metadata"
Widgets\10\Name="MediaAlbumArt.AlbumArt"
Widgets\11\Name="Rect.TimeLabelBackground"
Widgets\12\Name="MediaTimeLabel.TimeLabel"
Widgets\13\Name="Notification.MissedCalls"
Widgets\14\Name="Notification.UnreadSMS"
Widgets\15\Name="Notification.UnreadEmails"
Widgets\Size=15

#Widgets
# The [Name] must match the WidgetName defined in the Widgets list
[DateTime]
Alignment="center"
PosL="center;0"
PosP="center;0"
DateFont=";12;normal;0"
DateColor="255;255;255;255"
TimeFont=";30;normal;0"
TimeColor="255;255;255;255"
TimeFormat="hh:mm"
DateFormat="dddd dd/MM/yyyy"

[Rect_Bottom]
SizeL="800;70"
PosL="0;410"
SizeP="480;70"
PosP="0;730"
Radius=0
Color="0;0;0;150"

[Rect_Top]
SizeL="800;80"
PosL="0;0"
SizeP="480;80"
PosP="0;0"
Radius=0
Color="0;0;0;150"

[Battery]
Images=":/images/battery_0.png;:/images/battery_1.png;:/images/battery_2.png;:/images/battery_3.png;:/images/battery_4.png;:/images/battery_5.png;:/images/battery_6.png"
PosL="700;15"
PosP="380;15"
PercentageFont=";8;normal;0"
PercentageColor="255;255;255;255"

[UnlockButton]
WaitTimeMsec=1000
BackGroundImage=":/images/unlock.png"
BackGroundImagePressed=":/images/unlockPressed.png"
PosL="center;410"
PosP="center;730"

[PlayPauseButton]
BackGroundImagePause=":/images/pause.png"
BackGroundImagePausePressed=":/images/pausePressed.png"
BackGroundImagePlay=":/images/play.png"
BackGroundImagePlayPressed=":/images/playPressed.png"
PosL="210;160"
PosP="210;160"

[NextButton]
BackGroundImage=":/images/forward.png"
BackGroundImagePressed=":/images/forwardPressed.png"
PosL="280;160"
PosP="280;160"

[BackButton]
BackGroundImage=":/images/back.png"
BackGroundImagePressed=":/images/backPressed.png"
PosL="140;160"
PosP="140;160"

[Metadata]
TitleFont=";20;normal;0"
TitleColor="255;255;255;255"
ArtistFont=";14;normal;0"
ArtistColor="255;255;255;255"
Alignment="left"
SizeL="400;100"
PosL="140;90"

[AlbumArt]
SizeL="120;120"
PosL="5;90"

[TimeLabelBackground]
PosL="5;190"
SizeL="50;20"
Color="0;0;0;150"
Radius=0

[TimeLabel]
PosL="5;190"
SizeL="50;20"
Font=";10;normal;0"
Color="255;255;255;255"

[MissedCalls]
Icon=":/images/call.png"
PosL="center;250"
PosP="center;360"
SizeL="160;100"
Type="call"
Font=";14;normal;0"
Color="255;255;255;255"

[UnreadSMS]
Icon=":/images/message.png"
PosL="120;250"
PosP="left;360"
SizeL="160;100"
Type="sms"
Font=";14;normal;0"
Color="255;255;255;255"

[UnreadEmails]
Icon=":/images/email.png"
PosL="520;250"
PosP="right;360"
SizeL="160;100"
Type="email"
Font=";14;normal;0"
Color="255;255;255;255"
</pre>

If you change the configuration file you need to kill the lockscreen (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 shold 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]]