Introduction<\/h3>\n
By default, 5 themes are embedded in TunesArt since version 1.0 released in october 2010. TunesArt also supports external themes, stored in a bundle with a \u00ab\u00a0coverStyle\u00a0\u00bb extension. These themes can be installed easily, just by double-clicking on the file. Here, you’ll learn how to create a theme.<\/p>\n
1\/ File format<\/h3>\n
Themes are just a bundle with a special extension.
\nTo create such a bundle, first create a folder with Mac OS X Finder, then add \u00ab\u00a0.coverStyle\u00a0\u00bb at the end of the folder name.<\/p>\n
All your themes files will be stored in this bundle. The only required files are \u00ab\u00a0settings.plist\u00a0\u00bb (define all themes settings) and \u00ab\u00a0preview.png\u00a0\u00bb (used to display a theme preview in TunesArt preferences). Other files are typically images.<\/p>\n
2\/ Settings<\/h3>\n
You can download an example of a settings.plist file here : <\/i> SettingsTemplate.zip<\/a><\/p>\n Here are some explanations on how themes work. First image explains that all your theme images are always displayed on top of music track artwork. Second image will show you all size\/position settings (artwork and theme images).<\/p>\n CoverType<\/strong> Background<\/strong> BackgroundWidth<\/strong> BackgroundHeight<\/strong> BackgroundRatio<\/strong> Mask<\/strong> PosX<\/strong> PosY<\/strong> Width<\/strong> Height<\/strong> Opacity<\/strong> TextAlign<\/strong> A theme should always include a preview image, used by TunesArt preferences window.<\/p>\n This preview image must absolutely follow these guidelines: Please also include a Retina version of 256 x 256 px named \u00ab\u00a0preview@2x.png\u00a0\u00bb.<\/p>\n When you’re done, test your theme by double-clicking on the bundle.![\"\"](\"https:\/\/www.jibapps.com\/wp-content\/uploads\/2018\/12\/doc1.png\")
![\"\"](\"https:\/\/www.jibapps.com\/wp-content\/uploads\/2018\/12\/doc2.png\")
<\/p>\n
\nType: integer
\nPossible values: 0, 1, 2
\n0 is for a plain artwork, without any other theme image. Only one theme should use this setting (already embedded into TunesArt).
\n1 is for a theme with an overlay image (see \u00ab\u00a0Background\u00a0\u00bb setting), but no mask.
\n2 is for a theme with an overlay image and a mask.<\/p>\n
\nType: string
\nExample value: overlay.png
\nThis setting defines the overlay image to use in your theme. If your CoverType is equal to 0, please define the Background value to \u00ab\u00a0null\u00a0\u00bb. Note that this overlay will always be placed on top of the track’s artwork, so don’t forget to use alpha transparency in your overlay image, otherwise you’ll not see your artwork! Overlay is typically used to add a shadow around the artwork and some lighting effects on top of artwork.<\/p>\n
\nType: integer
\nExample value: 500
\nThis is the width of your overlay image, in pixels.<\/p>\n
\nType: integer
\nExample value: 500
\nThis is the height of your overlay image, in pixels.<\/p>\n
\nType: float
\nExample value: 1.189
\nTunesArt doesn’t calculate the ratio of your background image, so please define it (ratio=width\/height).<\/p>\n
\nType: string
\nExample value: mask.png
\nMask image is only used if CoverType is equal to 2 (in other cases, please define this value to \u00ab\u00a0null\u00a0\u00bb). A mask is useful to get non-square artworks: create a grayscale PNG image (white = opaque, black = transparent). The mask will be applied to the track’s artwork, and then the overlay will be added on top.<\/p>\n
\nType: integer
\nExample value: 15
\nArtwork X position in pixels, starting from left.<\/p>\n
\nType: integer
\nExample value: 15
\nArtwork Y position in pixels, starting form bottom.<\/p>\n
\nType: integer
\nExample value: 400
\nArtwork width, in pixels.<\/p>\n
\nType: integer
\nExample value: 400
\nArtwork height, in pixels.<\/p>\n
\nType: float
\nExample value: 0.6
\nThis defines the opacity value of the artwork (overlay image is not affected by this setting).<\/p>\n
\nType: string
\nPossible values: center, left
\nThis setting defines the text alignment of elements under the album cover (track’s title, artist, \u2026)<\/p>\n3\/ Preview image<\/h3>\n
\n– Size: 128 x 128 px
\n– Format: 24bits PNG with transparent background
\n– Filename: \u00ab\u00a0preview.png\u00a0\u00bb<\/p>\n4\/ Conclusion<\/h3>\n
\nBe careful: your theme will be automatically moved (and not just copied) to your user \u00ab\u00a0Library\/Application Support\/TunesArt\u00a0\u00bb folder.<\/p>\n