SKIN STUDIO / VERSION 0.1.92

How to edit a skin

Start with a skin file or the skin in your player. Follow the steps below to edit it and save your work.

Screenshots show the actual editor. Select a screenshot to view it at full size. Store versions may differ while an update is under review.

Jump to a section
01

Open a skin

  1. Open Cranamp. Select the lower-right corner of the top player window to open Settings. The circle marks that area.
  2. Choose Open Skin Studio.
  3. Select Continue editing to edit the working skin. To load a file, choose Open skin or project and select a .wsz, .zip or .cstudio file.
Player screenshot with a circle around the Settings area in the lower-right corner
Open Settings in this corner of the player.
The project screen. Continue editing opens the skin shown in the preview.
The project screen. Continue editing opens the skin shown in the preview. Full size

Keep an editable copy. A CSTUDIO file keeps paint layers. A WSZ file holds the finished player skin. Cancelling the file picker keeps the current document.

Start from a blank project

Choose New project on the project screen, then confirm Create blank project. This replaces the working document. Save your current project first.

The confirmation screen before creating a blank skin.
The confirmation screen before creating a blank skin. Full size
02

Choose what you edit

Choose Canvas at the top of the editor. Joined canvas shows the player windows together. Select a window in Skin windows for a closer view. Select a file in Source bitmaps to edit its sheet directly.

Desktop canvas: skin parts on the left, drawing tools beside the canvas, and pencil properties on the right.
Desktop canvas: skin parts on the left, drawing tools beside the canvas, and pencil properties on the right. Full size

Move and zoom

  • Use Pan canvas, the hand icon, to drag without painting.
  • Use two fingers to pan or pinch to zoom. A second finger cancels a tentative stroke.
  • Use the plus and minus zoom controls. Fit canvas, between them, shows the whole selected part.
  • Scroll with the wheel, middle-button drag or the canvas scrollbars. Ctrl + wheel zooms around the pointer.

Find the same controls on a phone

The top icons select Canvas, Sprites, States, Skin and Preview. Drawing tools and quick settings sit below the canvas. Select the current part name to change the part. The sliders icon opens the selected tool’s full settings.

On a wider window, the part list and tool properties appear beside the canvas. Layouts follow window width on every platform.

Phone and tablet layouts
Phone canvas with the palette and tool settings below the artwork.
Phone canvas with the palette and tool settings below the artwork. Full size
Tablet canvas with the part selector above the artwork and tool properties on the right.
Tablet canvas with the part selector above the artwork and tool properties on the right. Full size
03

Draw with the selected tool

  1. Select a tool beside or below the canvas. Use Drawing tools, the three-dot control in the tool strip, to see tools that do not fit in the strip.
  2. Set the properties for that tool. The small sample shows the current stroke or shape. Open Tool settings with the sliders icon for more controls.
  3. Draw on the canvas. Use Undo in the top bar to remove the last edit. Redo restores it.
Find a tool in Drawing tools
Drawing tools shows additional tools; the desktop example offers Glass lens and Taper.
Drawing tools shows additional tools; the desktop example offers Glass lens and Taper. Full size

Open a tool below for its steps and a screenshot of its settings.

Pencil

Choose Pencil. Set Size in skin pixels and Opacity, then drag to draw. Size 1 paints a one-pixel stroke.

The full settings include mirroring and grain. Clean corners changes how diagonal strokes meet.

Pencil settings.
Pencil settings. Full size
Line

Choose Line. Set Size and Opacity, then drag from the start point to the end point. Release to keep the line.

A completed drag creates one undo step.

Line settings.
Line settings. Full size
Rectangle

Choose Rectangle and drag between opposite corners. Turn Fill shape on for a filled rectangle; turn it off for an outline.

For a gradient, choose Down or Across and enter the end colour in To. Solid uses the current brush colour.

Rectangle settings.
Rectangle settings. Full size
Ellipse

Choose Ellipse and drag the bounding rectangle. Set Fill shape for a filled ellipse or use an outline.

The gradient controls work like the Rectangle tool. The sample at the top shows the current settings.

Ellipse settings.
Ellipse settings. Full size
Curve

Choose Curve. Set Size and Bend, then drag between the endpoints. Change the sign of Bend to curve in the other direction.

Review the curve while dragging. Release to keep it.

Curve settings.
Curve settings. Full size
Text

Choose Text. Enter the words in the Text field and set the text scale. Open the tool settings to choose the font and spacing, then drag to place the text.

The text becomes painted pixels. Put it on its own layer so you can remove or replace it later. Changing the text field affects the next placement.

Text settings.
Text settings. Full size
Lift pixels

Choose Lift pixels and drag a rectangle around the artwork to copy. The original pixels stay in place. Select Use copied pixels to switch to Stamp.

The captured rectangle appears in the tool preview. This copies rendered artwork into a stamp.

Lift pixels settings.
Lift pixels settings. Full size
Stamp

Capture a rectangle with Lift pixels, then choose Stamp. Set the flip or rotation controls and drag to place the copy.

Repeat places several copies along the drag. Sweep states distributes repeated stamps through sprite states; leave it off for ordinary copying.

Stamp settings.
Stamp settings. Full size
Glass lens

Choose Glass lens. Set Bevel and Refraction, then drag a rectangle over the artwork.

Use the tool sample to check the effect and Undo to remove a placement.

Glass lens settings.
Glass lens settings. Full size
Taper

Choose Taper. Set Size and Grain, then drag between the stroke endpoints.

Adjust Grain size for the texture. The sample updates as you change the settings.

Taper settings.
Taper settings. Full size

Brush settings affect new strokes. To change an existing shape, undo it and draw it again, or edit its pixels on a separate paint layer.

04

Choose and save a brush colour

  1. Select the palette icon, Brush colour. Wide windows also show the colour editor beside the canvas.
  2. Choose a hue and a point in the colour field, or enter an exact HEX value such as #4a80c2. RGB fields accept values from 0 to 255.
  3. Use Save colour, the plus icon, to add the current colour to Saved colours. To replace a swatch, select it, choose a new colour, then use Replace swatch, the pencil icon. The cross removes the selected swatch.
Brush colour with exact values and editable saved swatches.
Brush colour with exact values and editable saved swatches. Full size

Right-click on the canvas to sample a colour from the artwork. Save a CSTUDIO project to retain the palette.

Brush colour on a phone
The phone colour panel uses the same HEX and RGB controls.
The phone colour panel uses the same HEX and RGB controls. Full size
05

Keep changes on paint layers

  1. Open Painting layers with the stacked-sheets icon. Select the plus button to add a layer.
  2. Select the layer row before drawing. Its name appears beside Paint. The Source artwork row edits the original bitmap pixels directly.
  3. Use the eye to show or hide a layer and the lock to prevent edits. Select a layer to change its name or opacity. The arrows change its order.
A new Highlights layer is selected. Its name, opacity and order controls are above the layer list.
A new Highlights layer is selected. Its name, opacity and order controls are above the layer list. Full size

Merge down combines the selected layer with the layer below. Delete removes it. Undo can restore either action during the current session. Save as CSTUDIO to keep layers for later work.

Limit where new paint can land

In Tool settings, Lock transparency limits paint to existing pixels on the selected paint layer. Paint only this colour restricts painting to matching pixels. In Painting layers, Clip to layer below uses the layer below as a mask.

Pencil settings with a paint layer and paint limits enabled.
Pencil settings with a paint layer and paint limits enabled. Full size

If a stroke produces no visible change, check the selected layer, its eye and lock controls, and these paint limits.

06

Edit sprites and their states

Choose a control

Open Sprites and select the control to edit. A sprite is a skin image for a control, such as the Play button or a slider handle. The selected control limits the destination of new paint.

Sprites with the Play button selected for editing.
Sprites with the Play button selected for editing. Full size

Choose what you see and what you paint

  1. Use Active or Inactive above the canvas to choose the window appearance. Released or Pressed chooses the button appearance. Open Canvas state with the two-state icon near those controls.
  2. Under Paint into, choose This state to change the displayed variant. Choose All states when the same edit should reach every variant.

Check both selections before drawing. Viewing a pressed button does not limit painting to its pressed artwork. The Paint into setting controls that scope.

Active window, released controls, with Paint into set to This state.
Active window, released controls, with Paint into set to This state. Full size
Other window and button appearances
Active window with pressed controls.
Active window with pressed controls. Full size
Inactive window with released controls.
Inactive window with released controls. Full size
Inactive window with pressed controls.
Inactive window with pressed controls. Full size

Compare the variants

Open States to inspect the selected control’s artwork side by side. Check both button appearances. For sliders, inspect the low, middle and high positions before export.

The States workspace compares the selected Play button’s variants.
The States workspace compares the selected Play button’s variants. Full size
Inspect equalizer frames

Open Project actions, then EQ workbench. Choose a level under Level to paint and inspect its track and handle artwork. The equalizer uses shared source images, so an edit can affect several sliders.

Equalizer workbench for shared tracks, frames and handle artwork.
Equalizer workbench for shared tracks, frames and handle artwork. Full size
07

Change playlist and visualizer colours

  1. Open Skin, then Colours.
  2. Select the playlist item you want to change, such as Track text or Background. Enter its HEX or RGB value, or use the colour field.
  3. Select a visualizer swatch to change that slot. Check the playlist text samples and the visualizer preview.
Skin colours controls the playlist text and backgrounds, plus the visualizer palette.
Skin colours controls the playlist text and backgrounds, plus the visualizer palette. Full size

These settings control the playlist’s filled area and runtime text. Drawing on the canvas changes bitmap artwork. Use this screen when you want to change the playlist background or text colour.

Visualizer colours on a phone

Open Skin, then Colours and choose Visualizer. Select a palette slot and set its colour.

Phone visualizer palette and its colour editor.
Phone visualizer palette and its colour editor. Full size
08

Edit the font, window shape or cursors

Open Skin to reach these settings. Each has its own preview.

Player text font

Choose Text font. Set Font ink and Font background, then select Build classic text font. Use Edit font pixels to paint the bitmap letters directly. This changes the player’s font; the Text drawing tool places words on the artwork.

Text font with ink and background values, bitmap glyphs and a player preview.
Text font with ink and background values, bitmap glyphs and a player preview. Full size
Window shape

Choose Window shape. Set Cutout colour to the colour along the outside edge, then select Cut edge for the player or equalizer. Reset restores that window’s rectangular shape.

Window shape controls for the player and equalizer.
Window shape controls for the player and equalizer. Full size

The cutout affects the whole window, including any controls inside it. Magenta is ordinary artwork colour; it does not create a transparent hole in a sprite.

Cursor artwork and click position

Choose Cursors and select the cursor for a player region. Cursor X and Cursor Y set its hotspot: the pixel that acts as the click position. Choose Paint cursor to edit its artwork. If entries are missing, use Draw missing cursors to create them.

Cursor list with artwork previews and hotspot controls.
Cursor list with artwork previews and hotspot controls. Full size

Cursor display depends on the platform and input device. Touch input has no pointer to display.

09

Preview and check the skin

  1. Open Preview to see the skin rendered as a player.
  2. On desktop, select a thumbnail under State previews to inspect an alternate appearance. On smaller screens, use Pressed controls and Active window.
  3. Look for hard-to-read text and mismatched backgrounds around moving controls. Return to Canvas or Skin to make corrections.
Preview renders the current skin with player controls and text.
Preview renders the current skin with player controls and text. Full size

Check the exported format

Open Skin, then Format check. Resolve reported problems before exporting a WSZ. A valid format does not confirm that the artwork looks correct, so inspect the preview as well.

Format check shows whether the skin is ready for WSZ export.
Format check shows whether the skin is ready for WSZ export. Full size
Inspect a small group of pixels

Use Lift pixels to select an area, then open Project actions and choose Pixel study. Inspect the enlarged pixels in Color or Values mode. Include 4px surroundings adds context around the selection. Without a selection, the preview starts at the top-left.

Pixel study displays an enlarged area of the artwork.
Pixel study displays an enlarged area of the artwork. Full size
10

Save the project and export a skin

Select the save icon beside the canvas to open Save and share. You can also open Preview and select its share icon at the top-right.

Save and share separates the editable project from the playable WSZ skin.
Save and share separates the editable project from the playable WSZ skin. Full size
Save project
Writes a .cstudio file with layers and editable sources. Use this file when you want to continue editing.
Export WSZ skin
Writes a .wsz file for a player. Visible artwork is combined into the classic skin files.
Apply to player
Uses the current skin in Cranamp when Studio was opened from the player. Save a project separately to keep your editable work.
Save draft
Keeps a recovery copy on this device. Return to the project screen and use Restore last draft to reopen it.

To test an exported WSZ, return to the player and open that skin file. Keep the CSTUDIO file for future edits. Browser exports download files; native apps use the system file picker.

Find inspection tools from the canvas

The three dots in the top bar open Project actions. This panel contains Edit history and Pixel study. It also provides Sprite rectangles and the EQ workbench.

Project actions contains inspection tools and edit history.
Project actions contains inspection tools and edit history. Full size
11

Connect an agent on desktop

MCP lets a compatible agent use Studio’s drawing tools and edit history. It is available in desktop builds and is off by default. Android, iOS and the web do not include it.

  1. Open Agent connection from the top toolbar. In a narrow desktop window, find it in Project actions.
  2. Select Start server. Copy the HTTP server URL to your agent’s MCP settings. It is a localhost address on this computer.
  3. Select Test connection. Stop the server or close Studio when you finish.
Desktop Agent connection panel with server controls and the local access disclosure
Agent connection after the local server has started. Full size

While the server runs, connected programs can read or change the active skin and access files within Cranamp’s permissions. An agent may send the data it reads to its provider.

Get Cranamp

Skin Studio is included in Cranamp. The web version opens in your browser.