Download the image for the Amiko Viper 4K V20

Installing the image on the Amiko Viper 4K V20, step by step

The full image is installed on the receiver from a USB stick, through the receiver's update mode, without opening it. Preparing the stick on a computer takes a few minutes, and writing the image on the receiver a few more. Each step is below: what you do on the computer, what you press on the remote and what the front display of the receiver shows.

Before you start

• The image is at the beta stage: it runs on the receiver and testing goes on, so there may be mistakes.
• The archive is only for the Amiko Viper 4K V20. Do not install it on the Viper 4K V30 or V40, on the first Viper 4K or on any other receiver, even if it looks similar: each one needs its own image.
• Writing erases the current image, with its channel list, settings, plugins and everything you set by hand. Without a copy made beforehand, nothing can be brought back: in step 2 you make the settings copy (your channels come from it) and a copy of your current image.
• While the receiver is writing the image, do not unplug the power and do not remove the USB stick.
• Only the kernel and the system of the image are written. The receiver's start-up, its own data and its update mode stay untouched, so the receiver can always be restored from a USB stick, with any image made for the V20. The recordings on the receiver's disk are not deleted.

What you need

• A USB stick of 32 GB at most, with a single partition, formatted as FAT32, with at least 1 GB free.
• A computer (Windows, macOS or Linux), on which you download and unpack the archive.
• The receiver's remote.

Step 1. Prepare the USB stick

If the stick is already FAT32, skip the formatting. Formatting deletes everything on the stick, so do it now, before the settings copy, not after.

1. Put the USB stick into the computer.
2. On Windows: open File Explorer, under This PC right-click the stick and choose Format.
3. Under File system choose FAT32 and press Start. If FAT32 is not in the list, the stick is larger than 32 GB: use a smaller one.
4. On macOS: Disk Utility, choose the stick, Erase, the MS-DOS (FAT) format and the Master Boot Record scheme.

Step 2. Copy your settings and your current image (required)

The HD Satelit image erases everything now in the receiver's memory: the channel list, the settings, the plugins and programs you added, the skin, the picons in memory and everything you set by hand. Whatever is on a USB stick or disk stays. Without a copy made now, after the writing there is nothing to bring back. So you make two copies: the settings copy (the HD Satelit image brings your channels from it) and the image copy (so that you can go back exactly to what you have now). You need a USB stick, the remote, a computer and about half an hour.

If the receiver already has the HD Satelit image: Main menu > Settings > Software & Firmware > Settings copy (keys MENU 6 8 3); under “Copy location” choose the USB stick, then press OK or GREEN on “Make the copy now”. After the new image is written, with the stick in the receiver, the copy is put back by itself.

If the receiver has another Enigma2 image, do the following:

1. The USB stick: at most 32 GB, formatted FAT32 (on the computer: right click on the stick › Format › file system FAT32 › Start). Put it into the receiver.
2. The settings copy: in many Enigma2 images it is under Menu › Setup › Software Management › Backup System Settings (in others: Settings › Software › Backup settings or Backup). If it asks where to save it, choose the USB stick. It takes about a minute. A folder with a .tar.gz archive appears on the stick (usually enigma2settingsbackup.tar.gz).
3. If your image has no settings backup: copy the receiver's /etc/enigma2 folder onto the stick with an FTP program on the computer (for example FileZilla or WinSCP, user root). The HD Satelit image finds it that way too.
4. The image copy: also in Software Management, Image Backup. Use the arrows to choose your current image (the row with Current image), press GREEN (Start), then choose the USB stick. It takes 10-20 minutes; do not turn the receiver off while it works. At the end, an images folder appears on the stick.
5. The copies on the computer: take the stick out, put it into the computer and copy both copies to the computer (the images folder and the settings copy folder). Then delete only the images folder from the stick, so that it does not get mixed with the new image's files; leave the settings copy on the stick. If you want to go back to your current image, you write it from a USB stick as in Restoring the receiver, below. Only use a copy made on this receiver.
6. Picons (channel logos): if they are on a USB stick or disk, in a picon folder, they stay there and the HD Satelit image finds them by itself. If they are in the receiver's memory (/usr/share/enigma2/picon), copy the picon folder to the root of the stick.
7. Plugins: take a photo of their list in your current image, or write it down. They are not moved over: after the installation you add them again from Menu › Extensions & Apps, from the list or from an .ipk file on a USB stick (the From file tab). A plugin made for another image may not work. Many things people add plugins for are already in the image: translated subtitles, DAB+ radio, HbbTV, the web interface.
8. The network: write down the IP address, if you use a fixed one, and the Wi-Fi password. After the installation you set them again under Main menu › Settings › Network & Internet › Network Connection Setup (MENU 6 9 1). You choose the language, the resolution and the time again in the first-start wizard.

With the stick in the computer, go on to steps 3 and 4: you also put the new image on it. Do not delete the settings copy; the stick stays in the receiver during the writing and at the first start.

At the first start, after the wizard, the question “I found the channels and settings from another image. Shall I bring them over?” appears: press OK on Yes. The channels, channel lists, antenna settings and scheduled recordings are brought over, and at the end you see what was brought over and what was not. If you said No or put the stick in later: Menu › Channel scan › Import channels and settings (MENU 1 5), or from your phone, in the web interface, on the Import page. The steps, with pictures: https://stb.hdsatelit.com/en/ajutor/01-pornirea-si-prima-impresie/canalele-din-alta-imagine/

Step 3. Download and check the archive

1. Download the newest archive from the table above, with the Download button. It is a .zip file, named after the version and its date.
2. Check the SHA-256 checksum, so you know the archive arrived complete. On Windows, in PowerShell, in the downloads folder: Get-FileHash .\archive-name.zip -Algorithm SHA256. On Linux or macOS: sha256sum archive-name.zip.
3. The string shown must be the same as the one in the table. If it differs, download the archive again.

Step 4. Unpack the archive into the root of the USB stick

The archive does not go on the stick as it is: it is unpacked, and its folders must land directly in the root of the stick, not in a folder named after the archive.

1. On Windows: right-click the archive and choose Extract All. In the window that opens, delete the suggested path and type the letter of the USB stick, for example E:\, then press Extract.
2. Or: open the archive with a double click, select everything in it (Ctrl+A), copy it (Ctrl+C), open the USB stick and paste (Ctrl+V).
3. On macOS: a double click on the archive makes a folder with its name; copy to the stick what is IN that folder (the amiko and e2 folders and the two text files), not the folder itself.
4. Check the USB stick: it must look like the drawing below. Do not rename or move anything.

E:\  (the root of the USB stick)
├── amiko
│   └── viper4kv20
│       ├── imageversion
│       ├── kernel.bin
│       └── rootfs.tar.bz2
├── e2
│   └── update
│       ├── imageversion
│       ├── kernel.bin
│       └── rootfs.tar.bz2
├── CITESTE.txt
├── JURNAL-0.6.25.txt
└── (the settings copy from step 2)

The same three files are in two folders because the receiver looks for the image in the folder left by the last image that started: after the HD Satelit image, in amiko/viper4kv20; after others, in e2/update. This way it finds it whatever image you have now.

Remove the USB stick from the computer safely (Safely Remove), so that the files are written completely.

Step 5. Write the image on the receiver

1. Put the USB stick into the receiver's blue USB port (USB 3.0).
2. Restart the whole receiver from the remote. In the HD Satelit image: Main menu > Power & Restart > Restart Box (keys MENU 7 4); in another image, the restart of the whole receiver from its power menu. Unplugging the receiver and plugging it back in also works, but you do not need to.
3. Watch the front display of the receiver while it starts. When it shows MENU, press the GREEN button on the remote, pointed at the receiver.
4. The display shows UPDT: the receiver is writing the image. This takes a few minutes. Do not press anything, do not unplug the power and do not remove the USB stick.
5. At the end the receiver restarts by itself, with the new image.

Step 6. The first start

1. If you made the settings copy in the HD Satelit image (step 2), the receiver puts its settings and channels back by itself and starts straight on live TV, without the wizard; then skip to step 7.
2. Otherwise the setup wizard appears on the TV. On page 1, with “Language” selected, press LEFT or RIGHT (or OK for the list) until you reach your language.
3. Press DOWN and choose the resolution; if you do not know what to choose, leave 1080p Full HD 50 Hz. Press GREEN. If you changed the resolution, answer Yes to “Does the picture look right?” only if the picture really looks good; otherwise the previous one comes back by itself after 20 seconds.
4. On page 2 read about the receiver's features and press GREEN: the main menu opens.
5. Press EXIT to get to live TV. If the USB stick has another image's channels, the question “I found the channels and settings from another image. Shall I bring them over?” appears: press OK on Yes. A copy made in the HD Satelit image is put back by itself, without a question.
6. If you have no copy, search for the channels from the main menu: key 2 for the dish (if it is not set up yet or has a special LNB or switch), then key 1, Channel scan.

• The setup wizard
• Channels from another image

Step 7. Check the version

Main menu > System Information > About the image (keys MENU 4 1) shows the version of the image. It must be the one you downloaded. What it brings is under “What's new”, on the receiver, and under Changelog, on the site.

After the installation

• New versions come as updates over the internet: Main menu > Settings > Software & Firmware > Software update (keys MENU 6 8 1). You no longer need the USB stick.
• A new full image is installed the same way as now, from a USB stick; you find it in the table above, above the current one.
• The administrator (root) password is generated at random at the first start and is shown in Main menu > Settings > Network & Internet > SSH access. You only need it if you log in to the receiver from a computer; logging in works only from your home network.

• Software update
• Settings copy

Back to the image you had before

It is done the same way, from a USB stick, with the files of the other image (kernel.bin, rootfs.tar.bz2 and imageversion, if it has one). After the HD Satelit image, the receiver looks in the amiko/viper4kv20 folder, so put the files there, even if the other image's archive has them in another folder (for example e2/update). Make the settings copy first, as in step 2.

If it does not work

• The image forum: Amiko receivers
• The image forum: report a bug

The source code

The image uses programs under the GPLv2 licence. The source code of every published version is public on GitHub, in the Monea Software organisation; the link is on the Source page.

• Source code and licences