This project currently in alpha.

That means this is a work-in-progress. While in alpha project will be undergoing large amounts of cleanup and refactors.

Please proceed with caution because things probably will be a bit unstable. If a crash or other unintended result does occur, please report it so it can be addressed!

Until initial beta release recommended to use a read-only or watch wallet.

You will need Python and Git installed, can install both via apt with the command:
sudo apt install python3 git

recommended to use a virtual environment for separation and to ensure no dependency conflicts
mkdir K1
cd K1
python3 -m venv ./venv
source ./venv/bin/activate

git clone https://github.com/kevaone/narwhallet.git
cd narwhallet
pip install -r ./requirements.txt

pip uninstall kivy
mkdir kivy-deps-build && cd kivy-deps-build
curl https://raw.githubusercontent.com/kivy/kivy/master/tools/build_linux_dependencies.sh -o build_kivy_deps.sh
chmod +x build_kivy_deps.sh
./build_kivy_deps.sh
export KIVY_DEPS_ROOT=$(pwd)/kivy-dependencies
export USE_PANGOFT2=1
export KIVY_TEXT='pango'
pip install --no-binary :all: kivy

python3 ./main.py

pip install pyinstaller
cd share
pyinstaller linux_gui_with_deps.spec
cd dist
./Narwhallet

pip install buildozer
We also need older version of Cython; we can just use pip and install from wheel:
pip install https://github.com/cython/cython/releases/download/0.29.33/Cython-0.29.33-py2.py3-none-any.whl
buildozer android release

You will need Python installed, can download and install from https://www.python.org/downloads/windows/. You will also need Git which can be downloaded and installed from https://git-scm.com/download/win.

You can test the instilation status by opening a command prompt and issuing the commands:

python --version
git --version

If either of these commands fail check the instilation status of the program. If the program is installed it might not be added to PATH; consult the programs documentation on how to add.

recommended to use a virtual environment for separation and to ensure no dependency conflicts
mkdir K1
cd K1
python -m venv .\venv
.\venv\Scripts\activate

git clone https://github.com/kevaone/narwhallet.git
cd narwhallet
pip install -r .\requirements.txt

python3 .\main.py

pip install pyinstaller==5.6.2 pillow
cd share
pyinstaller linux_gui_with_deps.spec
cd dist
Narwhallet.exe

pip install buildozer
Also enable Windows Subsystem for Linux (WSL) and install a Linux distribution: https://docs.microsoft.com/en-us/windows/wsl/install to use buildozer with Windows
We also need older version of Cython; we can just use pip and install from wheel:
pip install https://github.com/cython/cython/releases/download/0.29.33/Cython-0.29.33-py2.py3-none-any.whl
buildozer android release

Upon launch Narwhallet will create the directory .narwhalllet within you're home directory. You're wallets, address book, settings and cache are saved here.

Create or restore bip32/bip49 based wallets

Restore an ypub or track wallet addresses

Track individual addresses