# Frequently Asked Questions

# License

# Is Kangaroo free?

February 1st, 2022, Kangaroo upgrade its End User License Agreemen (a.k.a “EULA”, “License Agreement”), based on this license agreement, the versions marked with Dev Beta are free for private or commercial use, others shoud be paid. See the product license for details.

# Is Kangaroo open source?

We will put it as a priority task if the project gain donation and support enough to make it be sustainable development.

# Version

# How do I find the version?

You can find the Kangaroo version information in the About dialog box.

On right of Kangaroo title bar, click the main menu button, then go to Help > About.

The Kangaroo version is the first Version number listed and has the version format 'major.minor.release.build', for example '0.8.5.191108'

# When to release stable version?

Kangaroo is working hard to make it be done, the stable version depends two point:

  1. Dependencies(GLib/GTK4)'s maturity and stability;
  2. Kangaroo's features' maturity and stability;

Based on all the information, the first stable version to be released at the fourth anniversary of the Kangaroo (2023.4.1).

# Language

# What languages does Kangaroo support?

English, Chinese will be support default, other languages depend on user contributation.

# How to switch for other languages?

Setting the environment variables first, then start the application. please refer to the platform documentation for the environment variables. 【Tip】The complete list of localized variables is as follows

LANG=zh_CN.UTF-8
LC_CTYPE=zh_CN.UTF-8
LC_NUMERIC=zh_CN.UTF-8
LC_TIME=zh_CN.UTF-8
LC_COLLATE=zh_CN.UTF-8
LC_MONETARY=zh_CN.UTF-8
LC_MESSAGES=zh_CN.UTF-8
LC_ALL=zh_CN.UTF-8
LC_PAPER=zh_CN.UTF-8
LC_MEASUREMENT=zh_CN.UTF-8

# Verify package

# How to verify the downloaded package?

Follow the steps:

  1. Download SHA256SUM and SHA256SUM.asc

  2. Get the key used for the signature
    apply for 1.6.1 and new versions
    The key ID is: 8C0C55F7DEC8FC52 (generated in 2021, current)
    The public key is: E4F02524471B195CCEFBD7158C0C55F7DEC8FC52

    apply for old versions before 1.6.1
    The key ID is: 702F717E0A17659D (generated in 2020, archived)
    The public key is: 33E5119C5781C1B37E56E580702F717E0A17659D
    gpg --keyserver hkp://hkps.pool.sks-keyservers.net --receive-keys 8C0C55F7DEC8FC52

  3. Verify the signature
    gpg --verify kangaroo-1.6.1.210131.sha256sum.asc

  4. Check the package with sha256sum
    run the following command from within the download directory to get SHA256 hash:
    sha256sum kangaroo-1.6.1.<else>
    then search the hash in the SHA256SUM file:
    grep <sha256sum output> kangaroo-1.6.1.sha256sum

# Support

# How track the changes?

you can put your eyes on follow ways: Twitter (opens new window) Github (opens new window) Gitee (opens new window) Official (here) (opens new window)

# Technical Support

You could submit your issues and requirements on the repository Github (opens new window) / Gitee (opens new window), or share your solutions about the trouble you've met.

# SQLite

Does Kangaroo compatible with other cipher algorithms? Yes, Kangaroo's default cipher algorithm is ChaCha20, it could compatible with database encrypted with other cipher algorithms like AES128/AES256/ChaCha20/RC4/Ascon-128, and SQLite legacy cipher modes, you could try it with SQLite URI parameters:

// Load database with the legacy SQLCipher Version 2 encryption scheme
file:databasefile?cipher=sqlcipher&legacy=1&kdf_iter=4000
// Attached database with same cipher with main database
// Database file directly
// Attached database with different cipher with main database
// Database file must be URI scheme
file:databasefile?cipher=chacha20

The following table lists the builtin cipher schemes:

Cipher Name Cipher ID Preprocessor Symbol Cipher
aes128cbc 1 CODEC_TYPE_AES128 wxSQLite3: AES 128 Bit (opens new window)
aes256cbc 2 CODEC_TYPE_AES256 wxSQLite3: AES 256 Bit (opens new window)
chacha20 3 CODEC_TYPE_CHACHA20 sqleet: ChaCha20 (opens new window)
sqlcipher 4 CODEC_TYPE_SQLCIPHER SQLCipher: AES 256 Bit (opens new window)
rc4 5 CODEC_TYPE_RC4 System.Data.SQLite: RC4 (opens new window)
ascon128 6 CODEC_TYPE_ASCON128 Ascon: Ascon-128 v1.2 (opens new window)
Last Updated: 2023-11-27T03:45:21.000Z