https://github.com/ohand/3dprinterstatus
small android app to get the status of a 3D printer for e.g. Bresser Rex or Flashforge Adventurer or similar - currently in an early stage
https://github.com/ohand/3dprinterstatus
3d-printer 3d-printer-controller android app bresser-rex cordova-build-environment flashforge flashforge-adventurer remote-state
Last synced: 9 months ago
JSON representation
small android app to get the status of a 3D printer for e.g. Bresser Rex or Flashforge Adventurer or similar - currently in an early stage
- Host: GitHub
- URL: https://github.com/ohand/3dprinterstatus
- Owner: ohAnd
- License: apache-2.0
- Created: 2023-03-04T00:48:35.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-05-01T18:30:22.000Z (over 2 years ago)
- Last Synced: 2025-04-18T12:19:17.312Z (9 months ago)
- Topics: 3d-printer, 3d-printer-controller, android, app, bresser-rex, cordova-build-environment, flashforge, flashforge-adventurer, remote-state
- Language: JavaScript
- Homepage:
- Size: 2.26 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
3DPrinterStatus
- [description](#description)
- [pre notice](#pre-notice)
- [original purpose for the app](#original-purpose-for-the-app)
- [features](#features)
- [downloads](#downloads)
- [get latest release](#get-latest-release)
- [get latest debug build](#get-latest-debug-build)
- [development status](#development-status)
- [screenshots](#screenshots)
- [features planned/ done](#features-planned-done)
- [info](#info)
- [licenses](#licenses)
- [creating local build environment](#creating-local-build-environment)
- [installing on linux](#installing-on-linux)
- [node js](#node-js)
- [cordova](#cordova)
- [java 11](#java-11)
- [android sdk commandline](#android-sdk-commandline)
- [gradle](#gradle)
- [preparing project](#preparing-project)
- [finally check with](#finally-check-with)
- [build](#build)
# description
## pre notice
project is based on [cordova build environment](https://cordova.apache.org/) and so written in NodeJS and cordova specific plugins - currently only builds for android available
contribution to this project is likely welcome
## original purpose for the app
Give an alternative way to reach 3D printer e.g. 'Bresser Rex' or 'Flashforge Adventurer III' directly in an app for getting the current state of print job and watching the live video stream from internal webcam.
Futher there are thougts to use that information to gather some statistics for visualization and use the state changes of printer for further switching of external IFTTT devices.
If you have other cool ideas please raise a [feature request](https://github.com/ohAnd/3DPrinterStatus/issues/new?assignees=&labels=content%2C+good+first+issue%2C+UX&template=feature_request.md&title=%5BFEATURE%5D+%3Cshort+summary+of+the+feature+request%3E)
## features
you can find already given and described content features here
[](https://github.com/ohAnd/3DPrinterStatus/issues?q=is%3Aissue+label%3Acontent+is%3Aclosed)
and UX marked features here
[](https://github.com/ohAnd/3DPrinterStatus/issues?q=is%3Aissue+is%3Aclosed+label%3AUX)
# downloads
## get latest release
you can reach the latest release here
[](https://github.com/ohAnd/3DPrinterStatus/releases)
## get latest debug build
goto the last (green) workflow run and find the .apk file in the artifact section below
[](https://github.com/ohAnd/3DPrinterStatus/actions/workflows/cordovaBuildAndroid.yml)
# development status
you can raise a feture or bug reqest here and also use this information
[](https://github.com/ohAnd/3DPrinterStatus/labels/bug) [](https://github.com/ohAnd/3DPrinterStatus/issues) [](https://github.com/ohAnd/3DPrinterStatus/issues?q=is%3Aissue+is%3Aclosed)
# screenshots
# features planned/ done
- open content the app recognized the finish state of the current job. This state could trigger a smart plug with MQTT or IFTTT. So it is maybe possible to integrate with a specific call on an url or direct MQTT integration.
- open content prevent connection with default values or inform user about the try to connect with default values
- done UX animation of changed values from printer, to recognize easily the changed value
- open UX button connect should be according to the current session state (currently: state info with butto color and button text without a direct understandable connection)
- done UX IP of printer should be directly take over for the webcam or at least offered
- open content also offer modeling tools e.g. freeCAD oder tinkerCAD
- open content offer temperature graph
- open content idea -> visualize current layer of printing with the XYZ data (why? Don't know! ;-) )
- open UX darkmode: invert colors to get dark environment
- open UX darkmode: switch darkmode with systemsettings
- open UX notification: local push notification, if printer job is done
- open UX notification: local push notification, if printer stopped before done, e.g. filament error (empty)
- open UX notification: progess should be optionally shown as an notification
- open content searching for printer in the local network, present result and give the option to take over to the printer connection
- open content show the video stream of webcam directly inside the app
- done UX notification: local push notification with progress as a permanent info during printing
- open UX notification: should be switchable on/off in settings
- done content stablize session to the printer - re-connect if connection lost, but the user still required an open connection (connect button -> not manually disconnected)
- done content notification: local single push notification every 10% during printing
# info
- current usage (at least until 0.0.1.0172) of connect/ disconnect button colors -> orange = is initialized / green = is connected / red = error occured (check debug log, e.g. BLOCKED means PC has already active connection to printer)/ blue = session releasing or finished
- "Bresser REX" offer itself as a "Flashforge Adventurer III"
# licenses
- logo was taken from here [Image by macrovector](https://www.freepik.com/free-vector/3d-printing-icons-set_4358644.htm#query=3d%20printer&position=1&from_view=keyword&track=ais") on Freepik
- ui template/ javascript based on https://github.com/chrisbroski/aerophane
# creating local build environment
## installing on linux
(almost same on windows)
### node js
`sudo apt install nodejs npm`
### cordova
`sudo npm install -g cordova`
### java 11
`sudo apt-get install openjdk-11-jdk`
### android sdk commandline
see also https://cordova.apache.org/docs/en/11.x/guide/platforms/android/index.html#requirements-and-support
`cd /usr/share`
`sudo mkdir android_sdk`
goto the download page for cmd line tools https://developer.android.com/studio/index.html#command-line-tools-only
unzip download to /usr/share/android_sdk
`sudo unzip commandlinetools-linux-9477386_latest.zip -d /usr/share/android_sdk`
`cd /usr/share/android_sdk`
`sudo mkdir latest`
`cd /usr/share/android_sdk/cmdline-tools`
`sudo mv * ../latest`
`cd /usr/share/android_sdk/`
`sudo mv latest /usr/share/android_sdk/cmdline-tools`
edit your ~/.bash_profile or ~/.profile
`export ANDROID_SDK_ROOT=/usr/share/android_sdk`
`export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools/`
`export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin/`
`export PATH=$PATH:$ANDROID_SDK_ROOT/emulator/`
reload terminal pathes
`source ~/.profile`
now e.g. for checking
`sdkmanager --list`
`sdkmanager --list_installed`
walking through the list for all the possible downloads/ installer
install needed build-tools
`sudo $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --install "build-tools;30.0.3"`
install platform with api level 30
`sudo $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --install "platforms;android-30"`
### gradle
`cd ~`
`wget https://services.gradle.org/distributions/gradle-8.0.2-bin.zip`
`sudo unzip gradle-8.0.2-bin.zip -d /usr/share`
`export PATH=$PATH:/usr/share/gradle-8.0.2/bin`
### preparing project
goto to your project folder (clone of git repo)
`npm install`
`cordova platform add android`
### finally check with
goto to your cordova project folder
`cordova requirements`
### build
`cordova build`