v7.

0 Theme Editor

2018. 01. 10.

Samsung Confidential 1
 History
Date Document Ver. Theme Editor Ver. Changes

2018.01.10 1.0 7.00.xx Created

Samsung Confidential 2
 Document
v1.0

Samsung Confidential 3
 Summary
 Addition of the Video Wallpaper product (standalone wallpaper with themes)
 Addition of the Animated AOD product (standalone AOD)
 Request to delete the badge image on animated products
 Request for performing a mandatory check on the theme application in the Messages app (New
Messages menu)
 Introduction to the theme product conversion method for the 2018 Project (2018 STP) O OS
- If the existing content (theme) is being sold by the seller,

only the theme products must be converted then uploaded to be serviced in O OS (Wallpapers, icons,
and AODs do not need to be uploaded after the conversion.)

Samsung Confidential 4
 Overview | 1. Addition of the Video Wallpaper product (standalone wallpaper
with themes)

 Video Spec.
- File format: MP4
- File resolution: 720(w)x1280(h)pixel, 16:9 ratio (portrait)
=> Since both left and right sides of the image gets cropped in devices
not in 16:9 ratio, it must be checked in the Preview in the Editor at production.
- File size: Maximum 100MB
- File duration: Maximum 15 seconds

 Screenshot Spec.
- Content to appear in the video. Need to insert 1 main screenshot.
- File resolution: 720(w)x1280(h)pixel, 16:9 ratio (portrait)
=> Since both left and right sides of the image gets cropped in devices
not in 16:9 ratio, it must be checked in the Preview in the Editor at production.

Samsung Confidential 5
 Overview | 2. Addition of the Animated AOD product (standalone AOD)

 Animated AODs can be produced.

=> In the Editor, a new menu will be added in AOD package>Animated AOD. (Scheduled to be provided at the end
of March, 2018)
 Animated AOD Spec.
- File format: GIF
- File resolution: 720(w)x540(h)pixel
- File duration: Min. 5 seconds - Max. 15 seconds
- File frame rate: Max. 20fps per second or less

Samsung Confidential 6
 Overview | 3. Request to delete the Animated badge image

 There is a need to remove the ‘ANIMATED’ badge provided by the Editor in the Preview mode.
 A function for automatically adding the badge on the product in the Theme Store is mounted.

Must Remove

If a product is uploaded without removing the badge,

we plan to reject it in the review process.

Samsung Confidential 7
 Overview | 4. Request for performing a mandatory check on the theme application in the
Messages app (New Messages menu)
 Message: Existing Message app/New Messages: New Messages app
=> Depending on the software version of the device, the theme is applied either with the existing Message app or the New Messages app.

 The creator of theme needs to create both Message and New Messages items for the message themes.
 The Message and New Messages must be created with a similar look & feel.

Samsung Confidential 8
 Overview | 5. Introduction to the conversion for the 2018 Project (2018 STP) theme

 In 2017, you could extract the N theme, Wallpaper, and Icon pack APK files for N OS.

 In 2018, you can now extract the O theme file for O OS.
(※ See ‘Overview| How Samsung Themes works’ on page 40.)

N.apk (Theme)

Menu > Export and

upload APK file
Wallpaper.apk & App Icon.apk for N OS

O.apk (Theme)

Samsung Confidential 9
 v5.0 Theme Editor

2017. 08. 07.

Samsung Confidential 10
 History
Date Document Ver. Theme Editor Ver. Changes

2017.03.17 1.0 5.00.20 Created

2017.08.07 1.1 5.00.4x Add policy regarding ‘Animated wallpaper’ and add component ‘Navigation bar icon’

Samsung Confidential 11
 Document
v1.1

Samsung Confidential 12
 Summary

 All of Animated wallpaper and theme including Animated lock-screen products,

- Should be inserted ‘Background image(1440x2560px)’.
- Need to check how it looks at 18.5:9 ratio devices.
- Need to check it was made according to the specifications properly that the editor gave.
- When uploading those contents to the Seller office site, please exclude Central and South American countries.
The reason is that some problems related to animated wallpaper have been found in the S8 device
and we have corrected it. Once the period of unchecked is over(estimated at the end of August),
we will check those countries again.
- In order to sell this content to Note 8, you must revise the existing product.

 Navigation bar icon images can be inserted.

 Maximum Number of Multi pack wallpaper product increased up to 20.
 Lockscreen needs visibility check.

Samsung Confidential 13
 Overview | 1. Animated wallpaper and theme including Animated lock-screen(1/2)

 Should be inserted ‘Background image(1440x2560px)’.

 Need to check how it looks at 18.5:9 ratio devices.(Grayed area is going to be cropped)
 Need to check it was made according to the specifications properly that the editor gave.

[ Limitation of creating an animated wallpaper ]

 Maximum Num. of Frame Action : 5
 Maximum Images Num. per Frame Action : 30,
Maximum Image Size : 240*240
 Minimum Frame Duration : 160ms

Samsung Confidential 14
 Overview | 1. Animated wallpaper and theme including Animated lock-screen(2/2)

 When uploading those contents to the Seller office site,

please exclude Central and South American countries.

Seller office web site > Country & Price > Advanced Please uncheck central and South American countries.
(Argentina, Brazil, Chile, Mexico)

Samsung Confidential 15
 Overview | 2. Navigation bar icon images can be inserted(1/2)
 You can insert 5 navigation bar icon images.(Recent/Home/Back/Multi window/Back Alt)
 You need to make sure that there is no visibility problem on each Preview screen.

Samsung Confidential 16
 Overview | 2. Navigation bar icon images can be inserted(2/2)
 Tint option “None”
- Navigation bar icon will be displayed on white/black/transparent backgrounds and background color that you set in the theme,
therefore, please make it look good regardless of any background color.

 Tint option “Tint”

- Color tint of Navigation bar icon image will be applied depending on the background color in device status,
therefore, please make shape or line type images for distinguishable when applying color tint.

Samsung Confidential 17
 Overview | 3. Max. Number of Multi pack wallpaper product increased up to 20

 Maximum Number of Multi pack wallpaper product increased up to 20.

Samsung Confidential 18
 Overview | 4. Lockscreen needs visibility check
 The color of the item below should be shown well in the condition. (Theme wallpaper + black 75% opacity)

Lock screen> General> Text Color Lock screen> Pattern Lock screen> PIN

Samsung Confidential 19
 Overview | 5. Phone>Dialer background image
 When designing the background image of the Dialer,
please prohibit the creation of background image with Grid or Circle shapes or keypad’s numbers.

1 2 3

4 5 6

7 8 9

* 0 #

Samsung Confidential 20
 Document
v1.0

Samsung Confidential 21
 Summary

 Specialized Wallpaper products(Multi pack/Motion/Animated) have been added.

-> Motion and Animated Wallpapers are extracted together with APK video files.
And upload the video file to ‘Youtube.com’, and add the video URL address when you upload the contents on the Seller site.

 From this version of Theme Editor, anyone can create AOD themes or AOD standalone products.
 You can change the Background color of Navigation bar when you create themes.
 You can insert the image of Iris mask when you create themes.(Lock screen>Iris)
 A preview has been added to check how the images included in theme contents are displayed
according to the device's H/W ratio Spec.

Samsung Confidential 22
 FAQ

 Abide by the rule of animated lock screen. STP file against this guide can not be exported.
[ Limitation of creating an animated wallpaper ]
 Maximum Num. of Frame Action : 5
 Maximum Images Num. per Frame Action : 30, Maximum Image Size : 240*240
 Minimum Frame Duration : 160ms
 Use the latest theme editor version. Content exported from the old version of tool may be rejected.
 In case of theme containing iris mask, write “Iris” on the tag at seller office.

Samsung Confidential 23
 Overview | 1. Specialized Wallpaper products - Multi pack
 Multi pack wallpaper is applied to lock screen only. This product can produce up to 8.
The images will change every time when user turn the screen on and off.

Samsung Confidential 24
 Overview | 1. Specialized Wallpaper products - Motion(1/2)
 The appearance of lock screen will change when user till the device left and right.

You can click this button to insert a wallpaper that

will change when user tilt device left / center / right.

Samsung Confidential 25
 Overview | 1. Specialized Wallpaper products - Motion(2/2)
 You have to upload the video file to ‘Youtube.com’, and add the video URL address when you upload the contents
on the Seller site. If you have not uploaded, it may fail in content verification
[Your PC] [Youtube.com]
1 2
*.mp4 video file is extracted. Upload *.mp4 video file to ‘Youtube.com’

[Seller office of Samsung Themes]

3
You should write down video URL address on description of contents

Privacy Settings : ‘Public’

Title of video :
[Samsung Themes-Motion Wallpaper] XXXXXX(anything you want)
Description of video:
[Samsung Themes-Motion Wallpaper]
XXXXXX(anything you want)
Tags of video :
‘Samsung Themes’, ‘Motion’, ‘Wallpaper’
https://www.youtube.com/watch?v=6PBpO6rn-oI
=>This is Example!!

Samsung Confidential 26
 Overview | 1. Specialized Wallpaper products - Animated(1/2)
 Animated wallpaper is the product that contains some moving objects.
This effect is supported only for lock screen. Before production, please refer to Page below in this guide file.
New | 7. Limitation of an animated wallpaper

Samsung Confidential 27
 Overview | 1. Specialized Wallpaper products - Animated(2/2)
 You have to upload the video file to ‘Youtube.com’, and add the video URL address when you upload the contents
on the Seller site. If you have not uploaded, it may fail in content verification
[Your PC] [Youtube.com]
1 2
*.mp4 video file is extracted. Upload *.mp4 video file to ‘Youtube.com’

[Seller office of Samsung Themes]

3
You should write down video URL address on description of contents

Privacy Settings : ‘Public’

Title of video :
[Samsung Themes-Animated Wallpaper] XXXXXX(anything you want)
Description of video:
[Samsung Themes-Animated Wallpaper]
XXXXXX(anything you want)
Tags of video :
‘Samsung Themes’, ‘Animated’, ‘Wallpaper’
https://www.youtube.com/watch?v=6PBpO6rn-oI
=>This is Example!!

Samsung Confidential 28
 Overview | 2. Add Navigation bar BG
 You can change the Background color of Navigation bar(Soft key) when you create themes.

Samsung Confidential 29
 Overview | 3. Add Iris mask preview image
 You can insert the image of Iris mask when you create themes.(Lock screen>Iris)
 You can download sample images(Menu>Export all resource images)

The white circle is the area where the actual eye should be located.
This part of image should be transparent when you create.

Samsung Confidential 30
 Overview | 4. Add preview 18.5 : 9 ratio
 A preview has been added to check how the images included in theme contents are displayed
according to the device's H/W ratio Spec. (Default - 16: 9 / Add - 18.5: 9)

Samsung Confidential 31
 Overview | 5. Modify AOD(Always-on display) product.
 From Theme Editor v5.0, anyone can create / sell AOD theme or AOD single product.
 The AOD theme or AOD single product works only on N OS or above.
 As before, you no longer need to test ‘Burn-in simulation’.

Samsung Confidential 32
 Overview | 6. Add guide file in Theme Editor
 You can read the guide file about Theme editor whenever you want.(Menu>Help)

Samsung Confidential 33
 Overview | 7. Compatibility and supportability between contents version of each product

If you want to know how the theme service works, please refer to the following page. Overview | 1. How Samsung Themes works

Theme Specialized
Single Wallpaper Icon pack (with basic or AOD
included animated lock screen & Wallpaper (Only)
AOD) (Multi/Motion/Animated)

Content
2.0
Version
Only supported
Not supported Not supported Not supported Not supported
OS M OS on M OS with s7 UX

UX S7 UX

Content
3.0
Version
Only supported Only supported Only supported
Not supported Not supported
OS M OS on M OS with Note 7 UX on M OS with Note 7 UX on M OS with Note 7 UX

UX Note 7 UX

Content Only supported

4.0
version on N OS with S8 UX.
Only supported Only supported Content versions 4.0 and 5.0
OS N OS Not supported Not supported
on N OS with S8 UX on N OS with S8 UX are compatible with each other.
(However, it may cause visibility issues
UX S8 UX on some screens of S8.)

Content Compatible with Compatible with

5.0
version Content version 4.0 Content version 4.0
Only supported
(If you have already (If you have already
OS N OS on M OS with S8 UX. Only supported Only supported
uploaded 3.0 and 4.0 uploaded 3.0 and 4.0
Content versions 4.0 and 5.0 on N OS with S8 UX on N OS with S8 UX
content to the seller site, content to the seller site,
are compatible with each other.
UX S8 UX you don’t need to convert you don’t need to convert
& upload the 5.0 content.) & upload the 5.0 content.)

Samsung Confidential 34
 Converting Tip | 1. Set Voice call BG Color
 You need to check the Voice call BG Color.(In 2016 STP Project, Phone>Voice call>Background color)

Samsung Confidential 35
 v4.0 Theme Editor

2016. 12. 09.

Samsung Confidential 36
 History
Date Document Ver. Theme Editor Ver. Changes

2016.12.09 1.0 4.00.15 Created

Samsung Confidential 37
 Document
v1.0

Samsung Confidential 38
 Summary

 From v4.0 Theme Editor, ‘L’ theme creation is not supported.(※Refer to 6 page)
 Two new menus are available(2016/2017) and two STP files(2016/2017) exist.
The 2016 is that you can export ‘M’, ‘M2’ theme, Wallpaper, Icon pack apk files for ‘M’ OS.
The 2017 is that you can export ‘N’ theme, Wallpaper, Icon pack apk files for ‘N’ OS.(※Refer to 6 page)
 Be able to produce separate contents-wallpaper, app icon.(※Refer to 22 page)
- You should convert from v3.0 wallpaper & App icon pack to v4.0, if you are already selling wallpaper, app icon contents

 Someone who designed Lockscreen in the theme with animated wallpaper should convert existing
M, M2 APK by v4.0 theme editor and update it on the seller site again.(※Refer to 9 page)

Samsung Confidential 39
 Overview | 1. How Samsung Themes works
 ‘Samsung Themes’ service is based on Touchwiz UX(basic UX) provided by Samsung.
And Touchwiz UX is based on basic UX of Android OS.
So, everytime the Android OS or Touchwiz UX changes, ‘Samsung themes’ service is also affected.

Theme 2015 2016 2017

L OS M OS N OS

Basic UX Basic UX Basic UX Basic UX

(for L OS) (for M OS) (for M OS & Note 7) (for N OS)

Theme v1.0 Theme v2.0 Theme v3.0 Theme v4.0

(L.apk) (M.apk) (M2.apk) (N.apk)

S6 Note 5 S7 Note 7 …
S6 Edge S7 Edge
… …
A8, J series A, J series …

ETC... (There are many devices that support ‘Samsung Themes’ service.)
Samsung Confidential 40
 Overview | 2. How we export APK for Theme/Wallpaper/Icon
 The 2016 is that you can export ‘M’, ‘M2’ theme, Wallpaper, Icon pack apk files for M OS.
 The 2017 is that you can export ‘N’ theme, Wallpaper, Icon pack apk files for N OS.
(※Please refer to ‘Information | How Samsung Themes works’ page.)
 From v4.0 Theme Editor, ‘L’ theme creation is not supported.

N.apk(Theme)

Wallpaper.apk & App Icon.apk for N OS

Menu>Export and upload APK file

M.Apk & M2.apk(Theme)

Wallpaper.apk & App Icon.apk for M OS

Samsung Confidential 41
 Converting Tip | 1. How do I convert STP from 2016 to 2017?
 Convert from STP(2016) to STP(2017) : Menu>Save project as (2017).
Convert from STP(2017) to STP(2016) : Menu>Save project as (2016).
 You can check which version of STP file was opened when you look at the title bar of editor.
version of STP file(2016 or 2017)

Samsung Confidential 42
 Converting Tip | 2. Change base image size
 In v3.0 Theme Editor, image size was specified based on WQHD resolution,
but in v4.0 Theme Editor, image size is specified based on FHD resolution.

Theme Editor ver.3.0.x Theme Editor ver.4.0.x

Samsung Confidential 43
 Converting Tip | 3. Lockscreen in theme with animated wallpaper
 Someone who designed Lockscreen in the theme with animated wallpaper should convert existing M, M2 APK
by v4.0 theme editor and update it on the seller site again.

 When users search theme in the Theme store, they can search with 'Animated' and have 'Animated' badge icon
automatically attached to products.

 The procedure is as follows.(※Same as the way you worked in v3.0 theme editor)
1) Open STP file in the v4.0 theme editor.
2) Check the STP version, ‘2016’.(You can check which version of STP file was opened when you look at the title bar of editor.)
3) Menu>Export and upload APK file.

Samsung Confidential 44
 Converting Tip | 4. Set content area BG color
 Set content area BG color.

2
1

Samsung Confidential 45
 Converting Tip | 5. Modify Action bar Background BG image
 Due to portrait image size is changed,
you need to modify action bar Background image when you convert Theme.
1
4

2
3

Samsung Confidential 46
 Converting Tip | 6. Modify Bottom bar BG
 Due to Bottom bar BG property is changed, you need to modify from 9-patch image to color.

1
4

Samsung Confidential 47
 Converting Tip | 7. Add stroke color item in Drop down menu
 Add stroke color item in Drop down menu

Samsung Confidential 48
 Converting Tip | 8. Add Stroke & Alphabet color in Photo ID
 Add Stroke & Alphabet color in Photo ID

3
4

Samsung Confidential 49
 Converting Tip | 9. Delete lockscreen clock background image
 Delete lockscreen clock background image

Deleted

Samsung Confidential 50
 Converting Tip | 10. Add lockscreen text shadow
 Add lockscreen text shadow

Samsung Confidential 51
 Converting Tip | 11. Delete components in voice call
 Delete voice call BG Color.
Due to Voice call BG Color is changed to a structure that extracts the wallpaper color, so it’s not necessary item.
 Delete Answer/Reject arrow icon.

Deleted

Samsung Confidential 52
 Converting Tip | 12. Add Messages text color in conversation view
 Add Messages text color in conversation view.

Samsung Confidential 53
 v3.0 Theme Editor

2016. 10. 13.

Samsung Confidential 54
 History
Date Document Ver. Theme Editor Ver. Changes

2016.07.04 1.0 3.00.14 Created

2016.10.13 1.1 3.00.21 p.20 : Added page(Resolution Tip | 1. Visibility issues in Gallery app)

Samsung Confidential 55
 Document
v1.0

Samsung Confidential 56
 New | 1. Wallpaper & Icon pack
 Wallpapers and App icons will be newly offered in Themes Store
 Sellers can create Wallpaper and Icon pack through theme editor

Samsung Confidential 57
 New | 2. Icon and text color on status area
 Sellers can change icon and text color, Black or White on status area
 Common > Background > Icon and text color on status area
 But it only supports for Note 7 or later OS update

 Sellers can set different status area color on previous devices

Should check
visibility issue
on previous device

Samsung Confidential 58
 New | 3. Live app icon
 Sellers can create live app icons for Clock and S Planner newly
 Live app icon will work for Note 7 or later OS update

Samsung Confidential 59
 New | 4. Wallpaper
 Wallpaper menu is separated from lockscreen menu
 Single wallpaper size should be in range from Min (1080 * 1920) to Max (2560 * 2560)

Samsung Confidential 60
 New | 5. App icon pack
 Mandatory to change 28 all preloaded app icons
 Sellers can add app icons in the Icon > App icons and change preview in the Icon > Preview
 3 preview images are created automatically in the editor and sellers can replace icon’s location

3rd Party App Icon

Cover image will be displayed in the theme store. on the app tray
It can be replaced through editor
Samsung Confidential 61
 New | 6. App icon preview
 Sellers can change cover image of app icon
 Sellers can change icon order or add alternative cover image

It could be cropped automatically

with 3:4 ratio in the theme store

Samsung Confidential 62
 New | 7. Limitation of an animated wallpaper
 Limitation of creating an animated wallpaper
 Maximum Num. of Frame Action : 5
 Maximum Images Num. per Frame Action : 30, Maximum Image Size : 240*240
 Minimum Frame Duration : 160ms

+ Add element
- Maximum Num.:30
+ Add frame action - Maximum Size : 240*240
- Maximum Num. : 5

Frame duration
- Minimum Value: 160 ms

Samsung Confidential 63
 New | 8. Upload apk files to seller site
 Each apk (Theme, Wallpaper, and Icon Pack) should be uploaded to seller site with preview file separately

[Icon Pack]

[Theme]
3 folders including apk and
preview files will be
created automatically

[Wallpaper]

Samsung Confidential 64
 Converting Tip | 1. Open previous stp file
 Total 7 apk files are exported ( 5 apk files for theme, 1 for wallpaper, 1 for icon pack )
 To convert previous themes for Note 7, sellers can use binary update in the seller site

[Preview] [Export APK]

7 This is added newly for

Note 7 and later model

Samsung Confidential 65
 Converting Tip | 2. Resize keyboard button image
 Check that images of keyboard are applied well
 Keyboard > Buttons & Text/Bubbles

Samsung Confidential 66
 Converting Tip | 3. Deleted quick setting icons background
 Quick setting icons background menu deleted.
Check that quick setting icons of quick panel are applied well.
 Notification panel > Notification panel > Quick setting icons color & Text color check

Deleted

Samsung Confidential 67
 Converting Tip | 4. Deleted Keypad background image of calculator
 Keypad background image of calculator deleted.
Set required background from image to color
 Calculator > Keypad Background check
Deleted

Samsung Confidential 68
 Converting Tip | 5. Keypad button position changed of Phone Dialer
 Keypad button position & grid line changed of phone dialer
 Phone > Dialer > Background image check

Theme Editor ver.3.0.x Theme Editor ver.2.0.37

Samsung Confidential 69
 Converting Tip | 6. Deleted Background image of Common Tab
 Deleted Background image of Common tab
 Common > Tab > Background Color check

Deleted

Samsung Confidential 70
 Converting Tip | 6. Added Selected text color of Email
 Added Selected text color of Email
 Email > List > Priority sender check

Samsung Confidential 71
 Document
v1.1

Samsung Confidential 72
 Resolution Tip | 1. Visibility issues in Gallery app
 Problem Definition
 As system software is updated, there are compatibility issues.

 Content needed to convert

 If you have not uploaded M.apk, made with v3.0 Theme Editor, on seller site before.
 If you applied Dark based color on ‘Common > Card view > Background color’
 Solution
① Run v3.0 Theme Editor.
② Please confirm, ‘Common > Card view > Background color & Unselected of Category Button’.
③ Convert M.apk made with v3.0 Theme Editor(latest version) & re-upload on seller site again.

‘Background Color’ is matched with ‘Background Color’ of Gallery apps

‘Unselected of Category button’ is matched with ‘Text Color’ of Gallery apps

Export ‘M.apk’

Samsung Confidential 73