v0.0.2-alpha

v0.0.2-alpha

What's Changed

• v0.0.2-alpha by @qlrd in #66

Full Changelog: v0.0.14...v0.0.2-alpha

WARNING: This release still in alpha; although it is minimally functional, there is a lot to improve and, therefore, it is possible that bugs and other unexpected behaviors may occur.

Thanks

Many thanks to:

• @odudex, @tadeubas, @jdlcdl and @kkdao, @3rdIteration and @easyux for the friendship, jokes, support, tips, critics, hacks, notes, tests, suggestions;
• @jdlcdl 's family for the generosity in the careful translation into French;
• @PMK for the time to carefully translate app into Dutch;
• All members of Krux Telegram group, specially 봉봉이, infinite1, Иннокентий;
• @OpenSats by showing that a life with sats is always more open to the best possibilities;
• @vinteumorg for the amazing network that was built with amazing people.

Details

• code refactoration from nodejs to python;
• re-build project from electron to kivy;
• Support for MacOS (arm64 and intel processors);
• Support to download older versions;
• Support to devices according to the appropriate version:
  • M5stickV;
  • Amigo;
  • Dock;
  • Bit;
  • Yahboom;
  • Cube;
  • WonderMV (only for beta firmware);
• Flash made with the ktool from its source;
• Wipe made with the ktool from its source;
• Added settings page:
  • Enable change path of downloaded assets;
  • Enable change of flash baudrate;
  • Enable change of locale;
• Added about page
• Locale support for 10 languages:
  • af_ZA (South Africa Afrikaans);
  • en_US (USA English);
  • es_ES (Spain spanish);
  • fr_FR (France french);
  • it_IT (Italian);
  • ko_KR (South Korean korean);
  • nl_NL (Netherlands dutch);
  • pt_BR (Brazilian portuguese);
  • ru_RU (Russian cyrillic);
  • zh_CN (Simplified chinese)

Installation

We always recomend to verify integrity and authenticity. For authenticity verifications, plese download developer's PGP key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

If it not works, try download the key and then:

gpg --import B4281DDDFBBD207BFA4113138974C90299326322.asc

Windows

• Download krux-installer_v0.0.2-alpha.Setup.exe;
• Execute the .exe file and allow it's execution;
• Follow the steps that will be show;
• Do not forget to create a desktop link;

MacOS (Intel and M1/M2/M3 processors)

• Download krux-installer_0.0.2-alpha_x86_64.dmg (Intel);
• Download krux-installer_0.0.2-alpha_arm64.dmg (M1/M2/M3);
• Click on DMG file and wait for a new volume open;
• Once open, drag the application to Applications folder;
• Open a terminal and type the following command to remove Apple's quarantine extended permission:

xattr -d com.apple.quarantine -r /Applications/krux-installer.app/

WARNING: Once a built-in python is loaded, it may be that the application takes 10 to 25 seconds to open, we will be working to improve this.

Fedora and like

• Download krux-installer-0.0.2_alpha-1.x86_64.rpm;
• Execute the following command:

sudo  dnf install krux-installer-0.0.2_alpha-1.x86_64.rpm

It will add the current user to dialout group to allow sudoless flash; maybe it will be necessary to reboot.

Debain and like

• Download krux-installer_0.0.2-alpha_amd64.deb;
• Execute the following commands:

sudo dpkg -i krux-installer_0.0.2-alpha_amd64.deb
sudo apt-get install -f

It will add the current user to dialout group to allow sudoless flash; maybe it will be necessary to reboot.

Other linux distributions

• Download krux-installer_0.0.2-alpha_amd64.deb;
• Execute the following commands:

ar xv krux-installer_0.0.2-alpha_amd64.deb
bsdtar -xvf data.tar.zst

The executable will be in ./usr/local/bin/krux-installer.

v0.0.14

What's Changed

Minor update: (Un)patched hard-coded verification that did not allowed cube be flashed with the official firmware. Now maixpy_cube users will be able to flash the currently v24.07.0

• Bump electron-store from 8.2.0 to 9.0.0 by @dependabot in #54
• Bump markdownlint-cli from 0.39.0 to 0.41.0 by @dependabot in #55
• Bump electron from 29.4.2 to 30.1.0 by @dependabot in #57
• Cube flash for official release by @qlrd in #60

Full Changelog: v0.0.13...v0.0.14

Many thanks for Selfcustody team: @odudex , @tadeubas , @jdlcdl , @kkdao, @3rdIteration, @easyux

Install

Follow instructions at out docs

v0.0.13

What's Changed

Major update: Added wipe feature: now users will be able to easily wipe their devices in a emergency case.

Minor update: Correction of records that were overlapped between flash sessions

by @qlrd in #50

Many thanks to all selfcustody team: @odudex, @tadeubas, @jdlcdl, @kkdao, @ytcryptoguide

Full Changelog: v0.0.12...v0.0.13

Install

Windows

This is a simple installer. Simple double click and follow the instructions;

Linux/AppImage

This is a simple standalone application. But you will need to allow execution with:

chmod +x krux-installer-0.0.13.AppImage
./krux-installer-0.0.13.AppImage

Debian/Ubuntu

sudo dpkg -i krux-installer_0.0.13_amd64.deb
sudo apt-get install -f

When its done, the krux-installer command will be available in your bash and in your desktop entries.

Fedora

sudo  dnf install krux-installer-0.0.13.x86_64.rpm

When its done, the krux-installer command will be available in your bash and in your desktop entries.

RHEL based distros:

sudo yum localinstall krux-installer-0.0.13.x86_64.rpm

or

sudo rpm -ivh krux-installer-0.0.13.x86_64.rpm

Developer PGP public key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

v0.0.12

Added major updates

This release will follow new features of krux firmware:

• Now maixpy_amigo_tft and maixpy_amigo_ips are unified as maixpy_amigo;

New two amigos:

• Added maixpy_yahboom in device list for both official and beta releases;

• Added maixpy_cube in device list (only for beta releases);

Many thanks to the selfcustody team: @odudex , @tadeubas, @jdlcdl, @kkdao and the telegram users for feedbacks. Without you guys, this release can't be done!

What's Changed

• Bump electron from 28.2.5 to 29.1.0 by @dependabot in #46
• Bump markdownlint-cli from 0.38.0 to 0.39.0 by @dependabot in #43
• Bump chai from 4.4.1 to 5.1.0 by @dependabot in #45
• Bump vite-plugin-electron from 0.15.6 to 0.28.2 by @dependabot in #47
• Bump @vitejs/plugin-vue from 4.6.2 to 5.0.4 by @dependabot in #48
• added yahboom and cube to devices list by @qlrd in #49

Full Changelog: v0.0.11...v0.0.12

Install

Windows

This is a simple installer. Simple double click and follow the instructions;

Linux/AppImage

This is a simple standalone application. But you will need to allow execution with:

chmod +x krux-installer-0.0.12.AppImage
./krux-installer-0.0.12.AppImage

Debian/Ubuntu

sudo dpkg -i krux-installer_0.0.12_amd64.deb
sudo apt-get install -f

When its done, the krux-installer command will be available in your bash and in your desktop entries.

Fedora

sudo  dnf install krux-installer-0.0.12.x86_64.rpm

When its done, the krux-installer command will be available in your bash and in your desktop entries.

RHEL based distros:

sudo yum localinstall krux-installer-0.0.12.x86_64.rpm

or

sudo rpm -ivh krux-installer-0.0.12.x86_64.rpm

Developer PGP public key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

v0.0.11

Added minor updates:

• An error page with quit buttons;
• Show an error page when flash fail;
• A quit button when flash is done;
• A .rpm package for Fedora Linux And RedHat Linux based distros with x86_64/amd_64 architetures;
• Fixed desktop icon for deb and rpm packages.

Many thanks to the selfcustody team: @odudex , @tadeubas, @jdlcdl , Jeff, Pacman and the telegram users for feedbacks !

Verify integrity/authenticity

Integrity

Download the properly <binary>.sha256.txt:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.11/<binary>.sha256.txt

Checksum:

sha256sum --check <binary>.sha256.txt

Signature

Import the public pgp key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

Download signature:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.11/<binary>.sig

Verify:

gpg --verify <binary>.sig

Install

AppImage

This is a simple standalone application. But you will need to allow execution with:

chmod +x krux-installer-0.0.11.AppImage
./krux-installer-0.0.11.AppImage

Windows

This is a simple installer. Simple double click and follow the instructions

Debian like

sudo dpkg -i krux-installer_0.0.11_amd64.deb
sudo apt-get install -f

Fedora

sudo  dnf install krux-installer-0.0.11.x86_64.rpm

Other RHEL based distros:

sudo yum localinstall krux-installer-0.0.11.x86_64.rpm

or

sudo rpm -ivh krux-installer-0.0.11.x86_64.rpm

When its done, the krux-installer command will be available in your bash and in your desktop entries.

v0.0.1

This is the first stable release of krux-installer.

🎅🏾 And the first one for debian-like users. Merry christmas 🎅🏾

The user experience did not changed, but some changes were necessary to keep the code up to date.

Full Changelog: https://github.com/selfcustody/krux-installer/blob/main/CHANGELOG.md
Please see this warning: https://github.com/selfcustody/krux-installer/blob/main/WARNING.md

Many thanks to the selfcustody team: @odudex , @tadeubas, @jdlcdl , Jeff, Pacman and the telegram users for feedbacks !

Verify integrity/authenticity

The process can change depending of used OS, where <binary> can be one of:

• krux-installer_0.0.1_amd64.deb
• krux-installer-0.0.1.AppImage
• krux-installer_0.0.1.exe

Integrity

Download the properly <binary>.sha256.txt:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.1/<binary>.sha256.txt

Checksum:

sha256sum --check <binary>.sha256.txt <binary>

Signature

Import the public pgp key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

Download signature:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.1/<binary>.sig

Verify:

gpg --verify <binary>.sig <binary>

Install

AppImage

This is a simple standalone application. But you will need to allow execution with:

chmod +x krux-installer-0.0.1.AppImage

Windows

This is a simple installer. Simple double click and follow the instructions

Debian like

To install you will need to execute two commands:

sudo dpkg -i krux-installer_0.0.1_amd64.deb

and then

sudo apt-get install -f

When its done, the krux-installer command will be available in your bash and in your desktop entries.

krux-installer v0.0.1-beta revision 2f0ee130

Summary

Major update summary:

• Changed to electron v26.2.2;
• Windows usage of openssl v3.1.3.

Minor update:

• Fixed how version is show at window header;
• Generation of revision according its current yarn.lock;

Changelog resume

• Removed class Electron from Electron.BrowserWindow
• Changed version to beta
• Added vite-plugin-html to dynamic header on top of window
• Updated windows build workflows

For more info, see full changelog see here.

Verify integrity/authenticity

The process can change depending of used OS; lets call a general `

Integrity

Download the properly <binary>.sha256.txt:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.1-alpha-6/<binary>.sha256.txt

Checksum:

sha256sum --check <binary>.sha256.txt <binary>

Signature

Import the public pgp key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

Download signature:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.1-alpha-6/<binary>.sig

Verify:

gpg --verify <binary>.sig <binary>

Warning

Many thanks to infinite1 from telegram group for patience to test MacOS release even with bugs in execution. Said that, its can still show the following errors during flash (which were not possible to reproduce since I do not have an apple machine) :

Error: 0:336: execution error: [1047] Cannot open PyInstaller archive from executable (/Users/user/Documents/krux-installer/krux-v23.09.0/ktool-mac) or external archive (/Users/user/Documents/krux-installer/krux-v23.09.0/ktool-mac.pkg) (255)

    at Socket. (/Applications/krux-installer.app/Contents/Resources/app.asar/dist-electron/main/index.js:6:381)
    at Socket.emit (node:events:513:28)
    at addChunk (node:internal/streams/readable:324:12)
    at readableAddChunk (node:internal/streams/readable:297:9)
    at Socket.push (node:internal/streams/readable:234:10)
    at Pipe.onStreamRead (node:internal/stream_base_commons:190:23)

And an GUI Alert Warning which I tried to mitigate in this PR:

A Javascript error occurred in the main process

Uncaught Exception:

Reference error: Electron is not defined

  at App.<anonymous>(/Applications/krux-installer.app/Contents/Resources/app.asar/dist-electron/main/index.js:1:3753)
  at App.emit (node:events:513:28)

Krux-Installer v0.0.1-alpha-6

What's Changed

• Updated from Urgent Security Issue by @qlrd in #29

Critical WebP bug: many apps, not just browsers, under threat.

The heap buffer overflow (CVE-2023-4863) vulnerability in the WebP Codec is being actively exploited in the wild.

Full Changelog: v0.0.1-alpha-5...v0.0.1-alpha-6

Verify integrity/authenticity

The process can change depending of used OS; lets call a general `

Integrity

Download the properly <binary>.sha256.txt:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.1-alpha-6/<binary>.sha256.txt

Check sum:

sha256sum --check <binary>.sha256.txt <binary>

Signature

Import the public pgp key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

Download signature:

wget https://github.com/selfcustody/krux-installer/releases/download/v0.0.1-alpha-6/<binary>.sig

Verify:

gpg --verify <binary>.sig <binary>

Krux-Installer v0.0.1-alpha5

What's Changed

• New UI by @qlrd in #20
• Bump vite-plugin-electron from 0.13.0-beta.3 to 0.14.1 by @dependabot in #21
• Fixing tests by @qlrd in #27

New Contributors

• @dependabot made their first contribution in #21

Full Changelog

v0.0.1-alpha-4...v0.0.1-alpha-5

Additional changes, but important

• Fixed some duplication of event calls that can lead to 'freeze' device on a 'suspended' state;
• Simplified the way of unzip and flash (unecessary files will not be zipped and user do not need to click a button to unzip, only select device, version, verify and flash);
• added pgp signature to verify the authenticity of files;
• used some updated librarires like electron-vite to build;
• updated to electron 26;
• build and test simplified;
• created MacOS release (Caution: untested in a real machine, can have bugs).

How to verify release with signature

Here are some steps to verify the binary. All steps are in Unix like system, but with windows you can verify with Gpg4Win:

Import the pgp public key:

gpg --keyserver hkps://keys.openpgp.org --recv-key "B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322"

Alternatively, you can download public key here and execute:

gpg --keyid-format long --list-options show-keyring B4281DDDFBBD207BFA4113138974C90299326322.asc
gpg --import B4281DDDFBBD207BFA4113138974C90299326322.asc

Download binary

Download the pair of binary/signature:

• Linux: krux-installer-0.0.1-alpha-5.AppImage and krux-installer-0.0.1-alpha-5.AppImage.sig
• Windows: krux-installer_0.0.1-alpha-5.exe and krux-installer_0.0.1-alpha-5.exe.sig
• MacOS: krux-installer_0.0.1-alpha-5.dmg and krux-installer_0.0.1-alpha-5.dmg.sig

Verify:

gpg --verify <binary filename>.sig  <binary filename>

Krux-Installer v0.0.1-alpha-4

Big thanks to @odudex and @tadeubas for suggestions, performing user tests and important UX notes.

Summary of Major updates:

1. Removed oldest firmwares options;
2. firmwares to choose will be only the latest official and odudex/krux_binaries;
3. improved E2E tests;
4. added support to maixpy_dock (by executing ktool with -dan option during flash);
5. using electron 24.1.2

What's Changed

• Linux appimage wdio by @qlrd in #5

Full Changelog: v0.0.1-alpha-3...v0.0.1-alpha-4

Linux Files:

• KruxInstaller-0.0.1-alpha-4.AppImage
• KruxInstaller-0.0.1-alpha-4.AppImage.sha256.txt

Windows Files:

• KruxInstaller Setup 0.0.1-alpha-4.exe
• KruxInstaller Setup 0.0.1-alpha-4.exe.sha256.txt