Status Desktop client made in Nim & QML https://status.app
Go to file
Richard Ramos 110bd25c06 Register signals for chat messages 2020-05-18 16:41:16 -04:00
fonts/Inter feat: add chat box, fonts and padding size 2020-05-12 16:42:19 -04:00
sqlite Update README.md 2020-05-13 09:27:27 -04:00
src Register signals for chat messages 2020-05-18 16:41:16 -04:00
ui chore: git should ignore *.qml.autosave 2020-05-18 11:44:04 -04:00
vendor fix: update dependencies 2020-05-18 11:42:50 -04:00
.gitignore chore: git should ignore *.qml.autosave 2020-05-18 11:44:04 -04:00
.gitmodules fix: signal handler integration with status-go 2020-05-18 11:42:50 -04:00
AppRun ft: AppImage 2020-05-15 18:03:55 -04:00
Makefile chore: DOtherSide shared lib extension differs by platform 2020-05-18 14:50:56 -04:00
README.md Clarify the required use of globals 2020-05-18 16:25:57 -04:00
build-linux.sh ft: AppImage 2020-05-15 18:03:55 -04:00
docker-linux-app-image.sh ft: AppImage 2020-05-15 18:03:55 -04:00
env.sh Adding nimbus-build-system 2020-05-15 17:18:20 -04:00
nim-status.desktop AppImg packaging 2020-05-15 17:18:20 -04:00
nim_status_client.nimble add various methods needed for wallet: get price, balance, convert hex wei to eth 2020-05-13 19:22:18 -04:00
screenRec.gif Initial commit 2020-05-06 13:40:00 -04:00
status.ico add status icon 2020-05-11 16:41:45 -04:00
status.svg Adding nimbus-build-system 2020-05-15 17:18:20 -04:00

README.md

nim-status-client

Experiments calling status-go from nim, inspired in nim-stratus by @arnetheduck

Building

0. Prerequesites

  • QT

install QT https://www.qt.io/download-qt-installer and add it to the PATH

# Linux
export PATH=$PATH:/path/to/Qt/5.14.2/gcc_64/bin

# macos
export PATH=$PATH:/path/to/Qt/5.14.2/clang_64/bin

Linux users can also install Qt through the system's package manager:

# Debian/Ubuntu:
sudo apt install qtbase5-dev qtdeclarative5-dev qml-module-qt-labs-platform
  • go - (used to build status-go)
# linux
<TODO>

# macos
brew install go

1. Install QT, and add it to the PATH

# Linux
export PATH=$PATH:/path/to/Qt/5.14.2/gcc_64/bin

# macos
export PATH=$PATH:/path/to/Qt/5.14.2/clang_64/bin

2. Clone the repo and build nim-status-client

git clone https://github.com/status-im/nim-status-client/ --recurse-submodules
make

if you previously cloned the repo without the --recurse-submodule options, then do

git submodule update --init --recursive
make

for more output use make V=1

3. Setup Library Path

export LD_LIBRARY_PATH=vendor/DOtherSide/build/lib/

4. Run the app

./bin/nim_status_client

Development

If only making changes in QML ui/ re-rerunning the app is enough If making changes in the nim code src/ then doing make again is needed (it's very fast after the first run)

Cold Reload

5. "Cold" reload using VSCode

We can setup a "cold" reload, whereby the app will be rebuilt and restarted when changes in the source are saved. This will not save state, as the app will be restarted, but it will save us some time from manually restarting the app. We can handily force an app rebuild/relaunch with the shortcut Cmd+Shift+b (execute the default build task, which we'll setup below).

To enable a meagre app reload during development, first creates a task in .vscode/tasks.json. This task sets up the default build task for the workspace, and depends on the task that compiles our nim:

({
  "label": "Build Nim Status Client",
  "type": "shell",
  "command": "nim",
  "args": [
    "c",
    "-L:lib/libstatus.dylib",
    "-L:-lm",
    "-L:\"-framework Foundation -framework Security -framework IOKit -framework CoreServices\"",
    "--outdir:./bin",
    "src/nim_status_client.nim"
  ],
  "options": {
    "cwd": "${workspaceRoot}"
  }
},
{
  "label": "Run nim_status_client",
  "type": "shell",
  "command": "bash",
  "args": ["./run.sh"],
  "options": {
    "cwd": "${workspaceRoot}/.vscode"
  },
  "dependsOn": ["Build Nim Status Client"],
  "group": {
    "kind": "build",
    "isDefault": true
  }
})

Next, add a .vscode/run.sh file, changing the DOtherSide lib path to be specific to your environment:

export LD_LIBRARY_PATH="/Users/emizzle/repos/github.com/filcuc/DOtherSide/build/lib"
../bin/nim_status_client

Auto build on save (for the "cold" reload effect)

Finally, to get trigger this default build task when our files our saved, we need to enable a task to be run while .nim files are saved, and when .qml files are saved.

Build on save

To build on save of our source files, first install the "Trigger Task on Save" VS Code extension to detect changes to our changable files, which will trigger a build/run. Once installed, update settings.json like so:

"files.autoSave": "afterDelay",
"triggerTaskOnSave.tasks": {
  "Run nim_status_client": ["ui/**/*", "src/*.nim"]
},
"triggerTaskOnSave.restart": true,
"triggerTaskOnSave.showStatusBarToggle": true