View source for Conversation Mods

The idea of modifying the way the Conversations App displays our SMS/IM conversations was initially brought up here in [http://talk.maemo.org/showthread.php?t=36618| this thread].


Below is a comparison of the default theme and a custom theme.

[[Image:Nokia-n900-1.jpg|frame|left|Default Nokia Theme]][[Image:LandscapeModeTest.png|frame|right|Custom Theme]]


==How To Mod The Conversations Theme==

Ejasmudar has created a tool to automate some of the following processes, it is still early in development and is mainly aimed to help people who aren't comforted typing in multiple lines of code into the terminal. The app can be found  [http://talk.maemo.org/showthread.php?p=959885#post959885 here]. For those of you who love fiddling around with your beloved N900 via X-Terminal, read on.

The location of the files that need to be modified in order to change the way our conversations look are located here <code>/usr/share/rtcom-messaging-ui/html/</code>. 

[http://talk.maemo.org/showpost.php?p=955831&postcount=808 This script] has been created in order to make it easier for people to apply the theme they have picked.

The <code>html</code> folder contains 10 files:

*3 files for the SMS theme
::<code>MessagingWidgetsSMSConversations.css</code>
::<code>MessagingWidgetsSMSConversations.js</code>
::<code>MessagingWidgetsSMSConversations.html</code>

* 3 files for the IM theme
::<code>MessagingWidgetsChatConversations.css</code>
::<code>MessagingWidgetsChatConversations.js</code>
::<code>MessagingWidgetsChatConversations.html</code>

* 3 files for the Single Message Theme
::<code>MessagingWidgetsSingleSMS.css</code>
::<code>MessagingWidgetsSingleSMS.js</code>
::<code>MessagingWidgetsSingleSMS.html</code>

* 1 file which contains the image for the user's avatar
::<code>avatar.png</code>

Here is a video tutorial with slightly modified steps as with above. Instead of using X Terminal, FileBox was used to copy/replace the files with modified themes: http://www.youtube.com/watch?v=PU8jiAG4H70

----

=== Backing up & Restore Themes ===

Just in case you do not want to backup the default theme. 

The files for the default theme can be found [http://talk.maemo.org/showpost.php?p=955520&postcount=803 here]

If you have a custom theme that you would like to save then here are some instructions for you.



==== Backing Up ====

:Open X-Terminal and type in the following to backup your current theme
 
<code>
 root
 mv MessagingWidgetsSMSConversation.css MessagingWidgetsSMSConversation.css.bak
 mv MessagingWidgetsSMSConversation.js MessagingWidgetsSMSConversation.js.bak
 mv MessagingWidgetsSMSConversation.html MessagingWidgetsSMSConversation.html.bak
 mv MessagingWidgetsChatConversation.css MessagingWidgetsChatConversation.css.bak
 mv MessagingWidgetsChatConversation.js MessagingWidgetsChatConversation.js.bak
 mv MessagingWidgetsChatConversation.html MessagingWidgetsChatConversation.html.bak
</code>

==== Restoring Your Backup ====

:Open X-Terminal and type in the following to restore your backup

<code>
 root
 mv MessagingWidgetsSMSConversation.css.bak MessagingWidgetsSMSConversation.css
 mv MessagingWidgetsSMSConversation.js.bak MessagingWidgetsSMSConversation.js
 mv MessagingWidgetsSMSConversation.html.bak MessagingWidgetsSMSConversation.html
 mv MessagingWidgetsChatConversation.css.bak MessagingWidgetsChatConversation.css
 mv MessagingWidgetsChatConversation.js.bak MessagingWidgetsChatConversation.js
 mv MessagingWidgetsChatConversation.html.bak MessagingWidgetsChatConversation.html
</code>

----

=== Changing Your Own Avatar ===

You have probably noticed that if you change the avatar for someone in your Contacts, their avatar also changes when they SMS or IM you.

This is great, but Nokia seemed to leave our own avatar non customisable..

'''NOTE: Only certain themes will show your avatar. Please check the screenshots below. If an avatar on 'your' side of the conversation isn't shown, then it is very likely the theme does not allow you to see your own avatar'''

:'''For those of you who love fiddling around with your beloved N900 via X-Terminal, here are some instructions on how to install a custom avatar:'''

# Find a picture that you want to use as your avatar and make sure its a <code>.png</code> file
# Resize that picture (using your favourite Photo Editing Tool) to 64 x 64 pixels
# Copy the resized picture onto the root directory of your N900 and rename it to <code>avatar.png</code>
# Now open X-Terminal and type the code shown below

 <code>root
 cp -f /home/user/MyDocs/avatar.png /usr/share/rtcom-messaging-ui/html/
 </CODE>
Voila! 

'''NOTE: Every change you make to the files within the <CODE>html</CODE> folder, to get the changes to show up, you have to either reboot, or type this into X-Terminal:'''

 <code>
 root
 killall rtcom-messaging-ui
 </code>


----

=== Installing A Custom Theme ===

Ejasmudar has created a tool to automate this process, it is still early in development and is mainly aimed to help people who aren't comforted typing in multiple lines of code into the terminal. The app can be found  [http://talk.maemo.org/showthread.php?p=959885#post959885 here]

'''For those of you who love fiddling around with your beloved N900 via X-Terminal, here are some instructions on how to install custom themes:'''

Firstly, create a folder in the root directory of your N900 called "html"
 <code>root
 mkdir /home/user/MyDocs/html
 </code>

Now follow the steps below to install a theme

# Select a theme that you want to use from the x section at the bottom of this wiki
# Download the zip/rar archive and unzip the contents to the <code>html</code> folder that you recently created
# Now open X-Terminal and type the following
 <code>root
 cp -f /home/user/MyDocs/html/* /usr/share/rtcom-messaging-ui/html/
 </code>
<nowiki>

</nowiki>
This will copy all the files across and into the correct directory. 

<nowiki>

</nowiki>


----

=== Creating IM Files ===

<nowiki>

</nowiki>



Most themes only contain the files for SMS and do not have the required files for IM.

Here is how to solve that problem. Seeing as the contents of both SMS and IM files are the same, you can simply created duplicates and rename them. 

Here is a simple method to do this, just type the following into X-Terminal

 <code>root
 cd /usr/share/rtcom-messaging-ui/html/
 cp -f MessagingWidgetsSMSConversation.css MessagingWidgetsChatConversation.css
 cp -f MessagingWidgetsSMSConversation.js MessagingWidgetsChatConversation.js
 cp -f MessagingWidgetsSMSConversation.html MessagingWidgetsChatConversation.html</code>


<nowiki>

</nowiki>


'''NOTE: Every change you make to the files within the <CODE>html</CODE> folder, you have to type this into X-Terminal:'''

 <code>
 root
 killall rtcom-messaging-ui
 </code>

==Themes==

Some of the themes below will support portrait mode correctly, whereas others will still have a horizontal scrollbar.

[http://talk.maemo.org/showpost.php?p=955933&postcount=1364 This] script will edit the themes below to allow them to better support portrait viewing. 

'''Note: The themes have been repacked to make it easy to install via Conversation Modder.''' In case original theme file is required, please use the link in the first column.

{| class="wikitable sortable"
! width="150" | Name
! width="100" | Created By
! width="80" | Portrait Support
! width="400" | Screenshot
! width="100" | Download
|-
| [http://talk.maemo.org/showpost.php?p=488625&postcount=33 Own Avatar] || b666m || No || [[Image:Own_Avatar.jpg]] || [http://www.sendspace.com/file/ztcahp Own_Avatar]
|-
| [http://talk.maemo.org/showpost.php?p=488677&postcount=35 Both Avatars On The Left] || b666m || No || '''N/A''' || [http://www.sendspace.com/file/8dolhi Download]
|-
| [http://talk.maemo.org/showpost.php?p=488898&postcount=39 Alternative Layout]  || b666m || No || [[Image:Alternative_Layout.jpg]] || [http://www.sendspace.com/file/e7j4te Download]
|-
| [http://talk.maemo.org/showpost.php?p=490675&postcount=54 IM Mod] || b666m || No || '''N/A''' || [http://www.sendspace.com/file/fa3t9u Download]
|-
| [http://talk.maemo.org/showpost.php?p=491919&postcount=62 Different Colours] || b666m || No || [[Image:Different_Colours.jpg]] || None
|-
| [http://talk.maemo.org/showpost.php?p=500704&postcount=89 Group By Sender] || termi_uc || No || [[Image:Group_By_Sender.jpg]] || [http://www.sendspace.com/file/d75l9x Download]
|-
| [http://talk.maemo.org/showpost.php?p=502287&postcount=108 Bubble Conversation] || Reflektorfalke || No || [[Image:Bubble_Conversation.jpg]] ||[http://www.sendspace.com/file/snihre Download]
|-
| Increased Text Size [http://talk.maemo.org/showpost.php?p=513658&postcount=159 Link 1] & [http://talk.maemo.org/showpost.php?p=513757&postcount=170 Link 2] || b666m || No || '''N/A'''||[http://www.sendspace.com/file/nsa0ja Download]
|-
| [http://talk.maemo.org/showpost.php?p=549706&postcount=337 Text & Avatar Bubbles] || b666m || No || [[Image:Text_&_Avatar_Bubble.png]]||[http://www.sendspace.com/file/dle56p Download]
|-
| [http://talk.maemo.org/showpost.php?p=560184&postcount=368 Simple & Lightweight] || Grant || No || [[Image:Simple_&_Lightweight.jpg]]||[http://www.sendspace.com/file/3g8728 Download]
|-
| [http://talk.maemo.org/showpost.php?p=571297&postcount=406 Simple] || m165 || No || [[Image:Simple.jpg]]||[http://www.sendspace.com/file/9e7ywa Download]
|-
| [http://talk.maemo.org/showpost.php?p=584573&postcount=422 Niqbal's Theme 1] || niqbal || No || [[Image:Niqbal's_Theme_1.jpg]]||[http://www.sendspace.com/file/lfpkdx Download]
|-
| [http://talk.maemo.org/showpost.php?p=586342&postcount=433 Niqbal's Theme 2] || niqbal || No || [[Image:Niqbal's_Theme_2.jpg]]||[http://www.sendspace.com/file/eftmwf Download]
|-
| [http://talk.maemo.org/showpost.php?p=594725&postcount=498 Niqbal's Theme 3] || niqbal || No || [[Image:Niqbal's_Theme_3.jpg]]||[http://www.sendspace.com/file/b4u8ia Download]
|-
| [http://talk.maemo.org/showpost.php?p=595887&postcount=505 Niqbal's Theme 4] || niqbal || No || [[Image:Niqbal's_Theme_4.jpg]]||[http://www.sendspace.com/file/k9mdo8 Download]
|-
| [http://talk.maemo.org/showpost.php?p=716643&postcount=623 Niqbal's Theme 5] || niqbal || No || [[Image:Niqbal's_Theme_5.jpg]] ||[http://www.sendspace.com/file/ig4y0d Download]
|-
| [http://talk.maemo.org/showpost.php?p=619349&postcount=550 Niqbal's Theme 6]|| niqbal || No || [[Image:Niqbal's_Theme_6.jpg]]|| [http://www.sendspace.com/file/qwi6i7 IM]
[http://www.sendspace.com/file/1knpi3 SMS]
|-
| [http://talk.maemo.org/showpost.php?p=587145&postcount=438 Spacing Mod] || byte_76 || No || '''N/A'''|| [http://www.sendspace.com/file/m6wdfy Download]
|-
| [http://talk.maemo.org/showpost.php?p=590272&postcount=460 Spacing Mod 2] || Kurele || No || [[Image:Spacing_Mod_2.png]]||
|-
| [http://talk.maemo.org/showpost.php?p=590272&postcount=460 Minimal] || Grant || No || [[Image:Minimal.jpg]]|| [http://www.sendspace.com/file/1motp3 Download]
|-
| [http://talk.maemo.org/showpost.php?p=601173&postcount=524 Xgrind] || xgrind || No || [[Image:Xgrind.jpg]]|| [http://www.sendspace.com/file/iqpg46 Download]
|-
| [http://talk.maemo.org/showpost.php?p=671953&postcount=594 Eitama Minimal] || eitama || No || [[Image:Eitama_Minimal.png]]|| [http://www.sendspace.com/file/br3ceq Download]
|-
| [http://talk.maemo.org/showpost.php?p=693861&postcount=601 Compact] || edanaher || No || '''N/A'''|| [http://www.sendspace.com/file/ph2afs Download]
|-
| [http://talk.maemo.org/showpost.php?p=731438&postcount=682 SR90's Themes] || SR90 || No || '''Multiple Themes In One. Check Thread For Screenshots!'''|| [http://www.sendspace.com/file/migqxl Original]
[http://www.sendspace.com/file/1l69fy 7610 Original]
[http://www.sendspace.com/file/2761h0 Blue]
[http://www.sendspace.com/file/dw4x7z Orange]
|-
| [http://talk.maemo.org/showpost.php?p=747400&postcount=729 N900 Compact] || TMarki || No || [[Image:N900_Compact.jpg]]||[http://www.sendspace.com/file/pful7r Download]
|-
| [http://talk.maemo.org/showpost.php?p=805399&postcount=751 Gsever's Theme] || gsever || No || [[Image:Gsever's_Theme.jpg]]||[http://www.sendspace.com/file/7w6qqh Download]
|-
| [http://talk.maemo.org/showpost.php?p=955088&postcount=791 Blue and Green Bubbles With Multiple Alignments] || godofwar424 || Yes || '''Multiple Themes In One. Check Thread For Screenshots!'''||[http://www.sendspace.com/file/hws2yl Right Alignment]
[http://www.sendspace.com/file/xlkqls Left Alignment]
[http://www.sendspace.com/file/x4mqkg Bubble Standard]
|-
| [http://talk.maemo.org/showpost.php?p=959335&postcount=849 MoonLight Style] || maxximuscool || Yes || [[Image:MoonLight_Style.png]]||[http://www.sendspace.com/file/7zu035 Download]
|-
| [http://talk.maemo.org/showpost.php?p=961411&postcount=899 Customisable Bubble Themes] || Harick  || Yes ||  '''Multiple Themes In One. Check Thread For Screenshots!''' ||Too many to repack as individual themes
|-
| [http://talk.maemo.org/showpost.php?p=962552&postcount=919 Apple Black & Avatar] || Harick  || Yes || ||[http://www.sendspace.com/file/lv8434 Download]
|-
| [http://talk.maemo.org/showpost.php?p=961304&postcount=889 Apple Green] || Harick  || Yes || ||[http://www.sendspace.com/file/67pf58 Apple Green]
[http://www.sendspace.com/file/g40xpe Apple Green Avatar]
[http://www.sendspace.com/file/mk70fy b66m portrait]
|-
| [http://talk.maemo.org/showpost.php?p=960637&postcount=866 Theme with Portrait Support] || Excesv|| Yes|| ||[http://www.sendspace.com/file/9tydvf Download]
|-
| [http://talk.maemo.org/showpost.php?p=959936&postcount=859 iphone UI] || Niqbal|| || ||[http://www.sendspace.com/file/jxztmn Download]
|
|-
| [http://talk.maemo.org/showpost.php?p=995119 Default theme with portrait IM and SMS] || Knarf|| Yes || '''Check Thread For Screenshots!''' ||[http://www.sendspace.com/file/v33kik Modded] [http://www.sendspace.com/file/h5dh5r Original look]
|-
| [http://talk.maemo.org/showpost.php?p=1012377&postcount=1024 F2thaK's Theme] || F2thaK || Yup || [[http://talk.maemo.org/attachment.php?attachmentid=20282&stc=1&d=1306032446]]||<< See thread to Download
|}

==Credits==

*andrewfblack
*b666m
*Reflektorfalke
*termi_uc
*qole
*Grant
*m165
*niqbal
*byte_76
*Kurele
*Xgrind
*eitama
*edanaher
*SR90
*TMarki
*gsever
*godofwar424
*Harick
*ejasmudar
*Knarf

[[Category:Community]]
[[Category:Software]]