JAlbum / Edit

This view mode allows you to view and edit RAW and other images, videos and their meta data and web locations. The toolbar at the top offers a set of image editing tools. The panel to the right lets you view and edit various properties or the current image. The field below the image gives you more space to enter a caption. Hint: You can drag the divider to increase space for entering captions. Pressing the space bar in edit mode will switch to Review mode

You can use SHIFT + ENTER to open with the Object in the selected external application.



Edit nav.png


These buttons will appear when you hover the mouse over an image/video. They allow you to navigate back and forth between images and to exit back to Explore mode. You can also use the arrow keys or the page up/down keys to navigate through the files in the current folder.


Pan and zoom

This lets you zoom in and pan around the image, it does not affect the image in your album. Shift/Alt/Opt/CMD clicking on the image will zoom in with the cursor over the same relative point, or if already zoomed in it will zoom out.

1. View and edit properties

(right hand side panel)

To open or close the panes click anywhere in the bar - little arrow, title, or even the blank area to the right. They also respond to left- or right-clicks.



A graphical representation of the tonal distribution in a digital image that plots the number of pixels for each tonal value. You can view data for luminance, red, green or blue channels, RGB combined or luminance and RGB together. The histogram tool can only be used to check your image. It is best used in conjunction with some of the other editing options, such as when changing brightness, contrast and saturation. As a general guide the histogram should ideally span the full width of the display area. If you see vertical lines within a histogram it may be an indication that an adjustment has been overdone. These lines represent missing shades of colour.

Edit Histogram ContextMenu.png

Control, or right clicking, the histogram window opens a menu letting you (un)dock the histogram or open its settings window. Double clicking the histogram window will also open its settings window.


The settings window allows you to choose what data the histogram displays by default, open the histogram in a separate window every time you start jAlbum and remember the windows location. You can also change the visual style to iPhoto (the default is Photoshop) and the foreground color can be changed (black or white).



This section provides information on, and allows the editing of, Name, Title, Date, Time, Star Rating and Flag. The name is the actual file name of the item. The title is the text that appears instead of the base file name, if entered, on your album web pages that show a title field. Date is what your operating system reports as when the file was last modified. Rating is a star rating system ranging from zero to five star. Flag is a means of categorizing files and, along with the star rating, can be used to filter files as a means of aiding project review. Flag has colours/values of None, Red/Select, Yellow/Second, Blue/Review and Green/Approved. Note: if write xmp metadata to files has been checked in Preferences?General>Write XMP metadata to files, then the title text is written to your files.



A variable can be predefined or user created and is added in two parts: the variable name and then its value.

A variable is only saved when you leave the field by clicking in, or tabbing to, an empty field.

Once a variable has been added, an empty row will appear, allowing further variables to be added. As an example of commonly used custom variables, entering ‘maxThumbWidth’ as the variable name and then for its value, say, 100, would set the maximum thumbnail width for this item to 100 pixels, regardless of the setting in Settings/Images/Thumbnails. To create a global custom variable you first have to define it in Settings/Advanced/User Variables. How custom variables work will depend on how well they are supported by a particular skin.

Note: Variables may also appear here as the result of either the core program or the selected skin; do not edit those variables unless you know exactly what the outcome will be.



Note: Location tagging only works with jpeg images.

If your image is already geo-tagged then the map will display the location it was taken. If not, or you wish to change the displayed GPS location, you can tag the image by either using the search box to look for the location (press 'Enter' to start the search or pick from the list of locations suggested) or enter the coordinate in the format 59.3325800, 18.0649000 (Latitude North, Longitude East for Stockholm, Sweden). Use negative numbers for South and West. For more information on using jAlbum's location pane click here



Provides non-editable details on camera settings. Hovering over the pane will result in further metadata being shown. For non-image files this will show just the file name.



This section provides, for the currently selected item, information on, and allows the editing of XMP metadata for: Creator, Keywords, Copyright and Copyright URL. Note: if write xmp metadata to files has been checked in Preferences>General>With xmp metadata to files, then the title text is written to your image files.

To apply the same data to a description field across all images control click the field, creator for example, and select 'Appy to all'.

Note, for web location objects keywords can be entered in explore mode but aret not currently supported In edit mode, they can be entered but they are not saved


360º image

If the currently selected image has an aspect ratio of 2:1 (for images that cover 360 by 180 degrees) it is likely to be a 360º photo sphere image and this panel will appear with the checkbox already selected. Should the image not be a photo sphere uncheck the box. This setting may be used by skins that support photo sphere images, by incorporating a 'viewer' which lets visitors pan around the image. If the image is a photo sphere but is not automatically detected you will need to edit the image and ensure the aspect ratio is exactly 2:1.

The other settings are stored as metadata, under 'xmp.GPano:' and are used by some photo sphere viewers, see individual skin manuals for information on those attributes. As it relies on metadata be sure to enable include photographic metadata in generated pages.

Note, if linking is to scaled down images, regardless of the image bounds chosen for regular images, slide images will be scaled down to the nearest power of 2, to a maximum of 8192x4096 pixels. Google's JavaScript based viewer library seems to prefer such sizes. For example, an image that is 5000x2500 pixels will be scaled down to 4096x2048 pixels; an image that is 4000x2000 pixels will be scaled down to 2048x1024 pixels; an image that is 20000x10000 pixels will be scaled down to 8192x4096 pixels.


Custom panels

Skins can add their own custom control panels in addition to those described above. In the image above the skin selected is Turtle and it has added two custom panels, Image data and External. For information on custom panels see the help pages or other documentation for the selected skin.

Some skins may have context sensitive help pages for custom panels. Opening a custom panel and clicking on the help (?) icon will take you either to the jAlbum Edit help page or to the skin's own custom panel help page.

2. Image editing (toolbar)

The image editing tools are non-destructive. For example cropping an image does not remove pixels. It merely masks them so that the crop can be altered or undone.

2.1 Exclude


Exclude or include selected item(s) from the album. Excluding an item keeps it within the project but excludes it from the generated album. This button toggles the state. An excluded item has a red circle with a white bar in it, similar to the exclude icon above.

2.2 Rotate


Rotates the image 90° to the left or to the right. Rotation occurs as soon as you click on the tool icon. There are no options to adjust.

2.3 Mirror


Sets a metadata flag so that the image appears to have left and right swapped, the result is as though it is being viewed through a mirror.

2.4 Crop


Cut the edges of the image to improve the composition. There are several options within the crop tool which, as for all tool options, can be hidden or revealed by clicking on the small right pointing triangle next to the tools name.


Adjustment points

You can hover over the image and click and drag on any of the white adjustment points. The midpoints adjust just the width or height whilst the corner points adjust both. The cursor changes to indicate the type of movement allowed.

Keep Ratio

If this option is selected then the predefined ratios (3.) are disabled, along with the height/width adjustment. (1.) Midpoints, and the aspect ratio is constrained to that of the un-cropped image. To crop the image click and drag on a corner adjustment point. You can also click on the image and drag the cropped area of the image around. With Keep Ratio un-checked the aspect ratio can still be retained by holding down the SHIFT key whilst dragging an adjustment point. To switch between landscape and portrait mode, just drag a corner point to the appropriate position.

Predefined Ratio

With keep ratio deselected you can click on this drop down menu and select from a range of crop ratios, such as Golden Ratio, 1:1, 4:5. Having used a predefined ratio you can still manually adjust by clicking and dragging the adjustment points at will.


As for all of the edit tools with options, having previewed your edits you need to apply them before exiting the tools interface. That includes switching from say, the crop to the enhance tool.


Having previewed the changes you decide not to apply the effect, you can press cancel, which will exit the tool but leave you in edit mode, or you can go directly to another (enabled) tool.

2.5 Straighten


Straightens the image, rotating to any given angle.


Drag to rotate

You can click on the image and drag to rotate.


You can enter any absolute angle, either positive or negative, to rotate the image a precise amount. For example typing 90 and then pressing Enter will rotate it ninety degrees clockwise, typing -90 would be counter clockwise. Alternatively you can click on the image and drag (see 1. in the figure) to rotate. A guide line will appear from the centre to the cursor and a second line will appear as you drag the cursor around. The rotation angle, between 0 and +/- 180, will be shown in the box.

Background color

Selects the color of the canvas that the rotated image ‘sits on’. For example selecting ‘keep size’ or ‘enlarge’ as the Mode and rotating the image will result in the image bounds being filled with the selected color.



Crop, Keep size and Enlarge. Crop will expand the rotated image, within the original image bounds, so that there is no background showing. Keep size will rotate the image and add background pixels as required to fill blank spaces. Parts of the image will be cropped out. Enlarge will reduce the rotated image so that it all fits within the frame, adding background pixels as required. See figure to the right.

Show Grid

If selected a grid is overlaid to help visualize the rotation, for example to fix horizontal or vertical alignment. The grid color is fixed so it may help to adjust the background color to make the alignment and then change it again, depending on the mode selected above.


Saves your edit.


Exit without saving changes.

2.6 Flip


Flip the image horizontally or vertically by swapping pixels.

2.7 Auto correct


Instantly improve the look of the image by automatically adjusting the colors, levels and/or contrast of the image. You may want to open the histogram tool at the same time, to see the changes graphically. By selecting Enhance all, jAlbum attempts to correct colors, contrast and brightness, all in one go.

Auto color

This tries to balance the colors thereby removing any color cast.

Auto contrast

This ensures that the image uses the maximum range of values for brightness.

Auto levels

This spreads the the range of values for each of the colors, ensuring the widest range possible is used.

2.8 Enhance


Adjust the brightness, contrast and saturation of the image to improve the look of an image. Sometimes the auto-correct tool does not quite do what you want. In these cases the enhance tool is better suited, as it gives you control over the adjustments. For all three controls the range of values that can be entered is -100 to +100, or drag the slider of each to adjust as required. It is recommended that you open the histogram tool at the same time, to see the changes graphically.

If you click on a control to change a setting the keyboard focus changes to that control and you can make single step changes using the the left/right arrow keys.

Levels Controls.png


Moves the luminance values towards the black (negative values) or white point.


Compress (negative values) or expand the luminance values within the image. Increases or decreases the contrast between the luminous and the dark parts of the image.


Defines a range from pure color (+100) to gray (-100). Desaturates (negative values) or saturates the colors, making the image fully desaturated will remove all color information, resulting in a gray scale image. Saturation influences the vividness of the the colors in an image.

Reset all

Returns all three settings to zero, leaving the image unadjusted.

2.9 Gamma


Change gamma value for each color channel: red, green and blue. Adjust the way highlights, mid-tones and shadows are treated, in a non-linear way, to correct for differences between source and target mediums. It is probably a good idea to open the histogram tool when adjusting the gamma.

If you click on a control to change a setting the keyboard focus changes to that control and you can make variable step changes using the the left/right arrow keys. The change in value increases as you move further from the centre point.

Gamma Controls.png

Gamma All

With individual settings unchecked the gamma all is active, the same adjustment is applied to all three color channels. If individual settings is checked this setting can still be adjusted but has no effect. The adjustment range is from 0 to 10.

Individual settings

This option allows each of the Red, Green and Blue channels to be adjusted independently.

Reset all

Returns all three settings to one, leaving the image unadjusted.

2.10 Effects


The effects below are applied to the displayed image, if you want to apply effects to all images see Album>Settings>Effects


Pixelate region

When the mouse button is clicked it will pixelate the area under the cursor, with the button held down move the cursor to 'brush on' the effect. Right or control clicking mouse button restores that area again The pixelation size can be adjusted by dragging the size adjuster. Use to 'Clear' button to remove the effect.

Red Eye

Removes the red eye effect often seen when a person is photographed with the camera and flash being too close to the subject. Click on the eyes suffering from red eye and the pupils should turn black. You can increase or decrease the size of the circle covering the eye by dragging it. If the effect is too strong, or too weak, enable the advanced options and change the settings. The strength of the effect is controlled by the sensitivity settings and the range of the effect by the maximum gap between pixels. Use small changes to the default settings to start with. You can remove an adjustment circle, if required, by selecting it and then clicking on the remove button.

Gray Effect

This converts a color image to a gray scale image. There are no settings to adjust.

Sepia Effect

This adds a sepia colored tint to the image. The strength of the tint can be varied from 0 to 100, not applied to full tint.

Sharpen Effect

Applies a preset amount of sharpening to the whole of the image.

Blur Effect

Applies a Gaussian blur to the whole image, with a strength setting of 0 to 100, no blur to completely out of focus.

Invert Effect

Inverts the colors in the image, black becomes white, red becomes cyan. There are no settings to adjust.

Pixelate Effect

Adds an effect to the whole image that is a bit like looking through frosted glass, the size of effect can be adjusted from 0 to 10.

Text Effect

Edit Effects Text.png

This allows you to add text boxes to your images. Each text box can have its own font, size, weight, alignment, color, transparency and shadow effect. The 'Set as default' will save the selected options such as font, size, bold etc. as the default settings for this filter. It does not save the entered text as a default.

Alt/Opt-click the 'Set as default' button to reset the settings to the factory defaults.

Arty Effect

This gives eight preset artistic effect filters for you to try. A thumbnail of your original is surrounded by the eight options. Hovering over each thumbnail reveals a tooltip that describes the effect. Clicking on a thumbnail will preview it on your image. Only one effect can be applied to an image.

2.11 Audio clip


This lets you play or record an audio file that is, or will be, attached to the object being edited. If an audio file is already attached the 'musical note' icon will be a reddish pink hue, otherwise it will look like the other icons. Clicking on the icon will open a small window with various controls. The '+' button opens a file explorer window allowing you to attach an audio file from your OS file system. The 'trashcan' icon will delete an existing attached audio clip. The record button will start recording from your audio input device, there is a volume level display to show if the sound is too quiet or loud. The play button will let you listen to the attached audio file. If a file is attached the file name is displayed, recordings are named after the object being edited.

2.12 Undo/Redo


Undo last applied tool and redo last undone tool. You can undo back to the original state.

3. Video editing

For information on editing videos click on this link

4. RAW editing

For information on editing RAW files click on this link

5. Web locations editing

Web locations lets you link to pages published to the web, so you can link to other albums, YouTube pages or anywhere on the web. You can manually enter relative URLs, drag and drop of relative URLs is not allowed.

In edit mode you can paste an updated path to the page, should it be changed at some point. You can also change the image used to represent the web page being targeted either by pasting the url of an alternative image or, by clicking on the folder icon, using the file browser to pick a local image. You can either paste the path to another image from the web or select a local file using the standard file chooser by clicking on the folder icon. Once the new path has been entered click on 'update' to set it.

If you want to make any edits, such as crop, straighten, flip, auto-fix, brightness, contrast, saturation, gamma or effects to the representing image you will need to use a local copy and add it to the project. Now exclude the local copy and edit it as required.

Supported file types are typical image file formats such as jpeg, png, gif etc. Note however that gif slide images will be the original as gifs are automatically set to ‘use original’.

Edit Weblocation.png