Cubic - App fails with invalid text encoding

If you encounter an error like:

    UnicodeEncodeError: 'ascii' codec can't encode character '\u2022'

This means you do not have UTF-8 support setup on your system.

Cubic requires UTF-8.

Ensure you have the locales package installed, and check that your system supports UTf-8.

    $ $ dpkg -s locales | grep 'Package\|Version'
    $ echo $LC_CTYPE
    $ echo $LANG
    $ locale
    $ locale charmap
    $ cat /etc/default/locale
    $ cat /etc/rc.conf
    $ cat /etc/locale.conf
    $ grep "^[^#;]" /etc/locale.gen
    $ python3 --version
    $ python3 -c 'import sys; print(sys.version_info); print(sys.stdout.encoding)'

Your output should look something like this.
Notice that all output shows "UTF-8".

$ echo $LC_CTYPE

$ echo $LANG
    en_US.UTF-8

$ locale
    LANG=en_US.UTF-8
    LANGUAGE=
    LC_CTYPE="en_US.UTF-8"
    LC_NUMERIC="en_US.UTF-8"
    LC_TIME="en_US.UTF-8"
    LC_COLLATE="en_US.UTF-8"
    LC_MONETARY="en_US.UTF-8"
    LC_MESSAGES="en_US.UTF-8"
    LC_PAPER="en_US.UTF-8"
    LC_NAME="en_US.UTF-8"
    LC_ADDRESS="en_US.UTF-8"
    LC_TELEPHONE="en_US.UTF-8"
    LC_MEASUREMENT="en_US.UTF-8"
    LC_IDENTIFICATION="en_US.UTF-8"
    LC_ALL=

$ locale charmap
    UTF-8

$ cat /etc/default/locale
    # File generated by update-locale
    LANG="en_US.UTF-8"

$ cat /etc/rc.conf
    cat: /etc/rc.conf: No such file or directory

$ cat /etc/locale.conf
    cat: /etc/locale.conf: No such file or directory

$ grep "^[^#;]" /etc/locale.gen
    en_US.UTF-8 UTF-8

$ python3 --version
    Python 3.8.5

$ python3 -c 'import sys; print(sys.version_info); print(sys.stdout.encoding)'
    sys.version_info(major=3, minor=8, micro=5, releaselevel='final', serial=0)
    utf-8

If you do not have UTF-8 support, follow these instructions.
(Replace "en_CA" in these instructions with the correct value for your locale).

(1)

$ sudo apt install locales

(2)

$ sudo dpkg-reconfigure locales

    Use <Page Up>, <Page Down>, <Up Arrow>, <Down Arrow> to navigate lists.
    Use <Space Bar> to select or unselect list items.
    Use <Tab> to switch between lists and buttons.
    Use <Left Arrow>, <Right Arrow> to switch between buttons.
    Use <Enter> to "Click" a selected Button.

(3)

On the 1st page "choose which locales to generate":

    Press the <Space Bar> to select "en_CA.UTF-8 UTF-8"
    Press the <Space Bar> to **UNSELECT** en_"CA ISO-8859-1"
    Continue to page through the list and ensure everything else is **Unselect**.

        [ ] en_CA ISO-8859-1
        [*] en_CA.UTF-8 UTF-8
        [ ] en_US.UTF-8 UTF-8

    (You may be able to select other locales, but do not select anything that doesn't say "UTF-8").

    Select "OK" to go to the next page.

(4)

On the 2nd page, "select the default language for the entire system":

    Scroll down and select "en_CA.UTF-8"

        en_CA.UTF-8

    (You can only select one default locale; make sure it says "UTF-8").

    Select "OK" to go to the next page.

(5)

You will see the following output:

    sxubuntu@xubuntu:~$ sudo dpkg-reconfigure locales
    Generating locales (this might take a while)...
    bn_BD.UTF-8... done
    .
    .
    .
    zh_SG.UTF-8... done
    Generation complete.

(6)

Reboot (or Logout / Login)