Features

This is a guide through major features of Piwigo NG.

Login

This is the first screen you will encounter after starting the application. In order to log into your Piwigo from the app, you need to fill the form:

• Url : Is the url address of your Piwigo (like https://example.piwigo.com). You only need to mention the body of the url, like example.piwigo.com or my-server.com/piwigo. You can switch protocols (http and https) by clicking on them. The url must not end with a /.

If you want to log in with a specific account, fill the following fields. If you let them empty, you will be logged as a guest.

• Username (Optionnal) : Is the account's name.
• Password (Optionnal) : Is the account's password.

Manage Albums

Once logged in, the app will redirect to the root of your album tree. Albums are represented by a card, it contains :

• The thumbnail of the album (can be changed on the server).
• The name.
• The description.
• It's content, with the number of sub-albums and images (recursive).

Navigation

Tap on an album to open it. It will show it's sub albums and images. Images are displayed in a grid, it's size can be changed from the settings. To go back to the root of your Piwigo from a sub album, simply press the bottom right grey button with the Home icon.

Create album.

If you are an administrator, or a user with specific rights, you can create an album (at root), or a sub-album. Here is how to do it :

• From the root, press on the bottom right button. From a sub-album, press the same button and then select Create album.
• Fill the from with the name and description (optionnal) of the new album. (the name can't be empty).
• Press Create album.

It will close the modal and refresh the page you added the album. Now, you should see your new album.

Album Actions

Like the creation, actions needs administrator rights. On the album cards, you should see an orange bar on the right. This means you have at least the right to upload files on this album.

To show the actions on an album, swipe the card to the left, or long-press on it. It will show 3 buttons :

• Edit, which it very similar to album creation.
• Move, will open a modal to select the destination album. You can't move an album into itself nor it's sub-albums.
• Delete, will show multiple deletion modes :
  • Keep Photos will remove all photos from the album but keep them in the Piwigo. It may crate orphans (photos that aren't in any album).
  • Delete Orphans will only delete photos that will become orphans, other will just be removed from the album.
  • Delete X Photos will delete all photos inside the album from the Piwigo. This means that if an image is present in two different albums, it will be removed from both.

Some of those actions can be found inside the album, with the top right menu.

Manage photos

Like the albums, administrators can do several actions to the images. You can have access to these actions in two ways :

• Image preview : From an album, press an image thumbnail to poen it's preview.
• Selection mode : From an album, long-press on an image thumbnail to trigger the selection mode. Then, press all the thumbnail you want to inclide in the selection.

Both ways will show the actions on a bottom bar and a top right menu. It includes :

• Favorite : Add or remove the image from your favorites. All favorites can be accessed from the top right menu on at the root.
• Share : Share the image through another application.
• Download : Download the image with it's original size.
• Edit : Edit your photo's name, description (comment), privacy (see Piwigo privacy modes), and tags. In case you are editing a list of images, the name and description will be applied to all (unchanged if left blank).
• Move or Assign : After choosing an album (except root), there are two options :
  • Move : Removes the photos from the current album and add them to the destination.
  • Assign : Link the photos to the destination album.
• Delete : Photo deletion uses the same options as the albums depending on the selection.

Upload

In order to add images to your Piwigo from the application, you must do an upload. Upload is only available to administrators and community users. The upload feature can be accessed by pressing the bottom right button while inside an album, then choose either Upload Photos or Take Photo.

• Upload Photos will open your device's file explorer to select the ones you want to upload.
• Take Photo will open the camera, to take a photo or a video.

Then, you will be redirected to the Upload configuration page. From tis page, you can add some information about the photos like the name, description (comment), privacy and tags. This form works the same way as the image edition. All fields are optionnal and won't be used if they are blank.

There is also an overview of the files you picked or took from your phone. You can remove them or add new ones to the selection. Photos that are already in the Piwigo won't be uploaded and will be greyed out.

When everything is setup, press the Upload button to start. The app will redirect to the upload summary page, where you can see the current progress and status of all the images that are uploading, and also cancel the upload of a specific file.

Once the upload completed, you will recieve a notification with the overall status of the upload process, if it's are enabled in the settings.

Auto Upload

Auto Upload is a brand new feature for Piwigo NG. It is very similar to the manual Upload, except that it is programmed to be executed in background periodically and without the intervention of the user.

To set this up, go to the application settings :

• From the root album, press the top left button.
• Then, in the Upload section, go to Auto Upload.

In order to activate the auto upload, you need to :

• Choose a Source folder from your phone.
• Choose a Destination album from your Piwigo.
• (Optionnal) Choose a frequency (hours, days, ...).
• And then, enable the auto upload.

An upload will start directly after being enabled.