[](https://github.com/Spagett1/PineFlash/releases/)
[](https://github.com/Spagett1/PineFlash/releases/)
# PineFlash
A GUI tool to flash IronOS to the Pinecil V1, V2 and future other pine products.
If you need help, or want to help out with development, I have a [discord server](https://discord.gg/NHrXJRan7D) and a bridged [matrix space](https://matrix.to/#/#spagett's_cookhouse_of_spaghetti_code.:matrix.org).
## Features
* Auto-fetch the newest stable release of IronOS firmware.
* Allows manual installs of beta versions using a browse to file feature.
* Selectable options: pick the iron type, pick the firmware version and download it.
* Boot logo art upload supported for V1 and V2 (use custom & folder icon)
Linux | 
MacOS| 
Windows|
| :-----: | :-----: | :-----: | :-----: |
| Pinecil V1 |
|*| |
| Pinecil V2 | | * | |
* Pineflash on MacOS must be compiled from source.
# :desktop_computer: Install Options
1. Easy install: use premade binaries, currently only available for Linux x86 distros and Windows x86.
2. Build from Code: recommended if you are on MacOS, an ARM device, or doing development.
Windows
Download the latest pineflash exe file from the [releases page](https://github.com/Spagett1/PineFlash/releases).
Then just double click it.
### 
RedHat distros (Fedora, Centos, Nobara, Rocky, etc.)
Download the latest pineflash .rpm file from the [releases page](https://github.com/Spagett1/PineFlash/releases).
Then just run.
```
sudo dnf install ./pineflash-*.x86_64.rpm
```
### 
Arch based distros (Arch, Artix, Manjaro, Endeavor, etc.)
Download the latest pineflash pkg.tar.zst file from the [releases page](https://github.com/Spagett1/PineFlash/releases).
Then simply run.
```
sudo pacman -U pineflash-*-x86_64.pkg.tar.zst
```
### 
Debian based distros (Debian, Ubuntu, PopOs, etc.)
Download the latest pineflash .deb file from the [releases page](https://github.com/Spagett1/PineFlash/releases).
Then just run.
```
sudo apt install ./pineflash_*_amd64.deb
```
### 
Other Linux x86 distro's
Download the latest pineflash .tar.xz file from the [releases page](https://github.com/Spagett1/PineFlash/releases).
Extract the file.
```
tar -xf ./pineflash-*-x86_64.tar.xz
```
And copy the contents into your system
```
doas cp -r ./usr /
```
> **_NOTE:_** Make sure you install dfu-util manually and that it is at least version 0.11 as older versions can have issues. Window manager users should ensure they have a pokit agent installed and enabled.
### 
MacOs
Sorry we dont have built apps for you yet, head to the build from source section and use the unix install script.
> **_NOTE:_** You will also need to run pineflash from the terminal, this is on the todo list to get fixed.
General dependancy list
Dependencies for Debian
Dependencies for Arch
Build Unix from script. (Macos and Linux)
1. To build from source code, first install build dependencies.
2. Download the source code with the following commands.
```
git clone https://github.com/Spagett1/PineFlash/
cd PineFlash
```
3. Run the `generic_unix_install.sh` file which will build and install Pineflash.
### Build on Arch based distro's (Arch, Artix, Manjaro, Endeavor, Arch Arm, etc.)
1. All dependencies will be handled by the PKGBUILD
2. PineFlash is in the aur so you can install it just like any other aur package.
```
git clone https://aur.archlinux.org/pineflash-git.git
cd pineflash-git
makepkg -si
```
3. Alternatively just use your favourite aur helper.
Linux: Pineflash should appear in app launcher options. Alternatively, you can run the command:
pineflash
MacOS: Sorry, no launcher icon yet, you'll need to run this command to run pineflash.
pineflash
Windows: Just run pineflash from the start menu.
If there is error message like
```
Cannot open DFU device ... (LIBUSB_ERROR_NOT_SUPPORTED)
```
during flash operation, then `WinUSB` drivers should be installed. See [here](https://github.com/libusb/libusb/wiki/Windows#user-content-How_to_use_libusb_on_Windows) for more details.
## Boot Logo Art
- Select your Pinecil version.
- Click on the folder icon to browse to the art file you want to load.
- For the v2 you must have IronOs v2.22 installed to support boot logo.
- If you encounter errors with flashing boot logo's to the v2 ensure your blisp version is at minimum 0.0.4.
- See [IronOS-Meta](https://github.com/Ralim/IronOS-Meta/) to get premade art or details on how to make custom art.
## :book: References
- [Blisp](https://github.com/pine64/blisp) - Backend for flashing Pinecil V2
- [Dfu-util](https://dfu-util.sourceforge.net/) - Backend for flashing Pinecil V1
- [Pinecil](https://wiki.pine64.org/wiki/Pinecil) - The Pinecil Wiki page
- [IronOS](https://github.com/Ralim/IronOS) - The firmware running on this soldering iron
- [PineSAM](https://github.com/builder555/PineSAM) - A cool Bluetooth app to control Pinecil V2 from any browser
- [Egui](https://github.com/emilk/egui) - The awesome GUI toolkit used to make this program
- [InnoSetup](https://github.com/jrsoftware/issrc) - The software i use to generate windows releases
- [FPM](https://github.com/jordansissel/fpm) - The tool i use to generate linux releases for all sorts of distros
## :dash: Stay fluxy my friends.
[Source](https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/)
================================================
FILE: assets/Pineflash.desktop
================================================
[Desktop Entry]
Name=PineFlash
GenericName=PineFlash
Comment=Tool to flash pine64 devices
Exec=pineflash
Icon=pine64logo
Terminal=false
Type=Application
Categories=System
X-Desktop-File-Install-Version=0.26
================================================
FILE: build.rs
================================================
extern crate winresource;
fn main() {
if std::env::var("CARGO_CFG_TARGET_OS").unwrap() == "windows" {
let mut res = winresource::WindowsResource::new();
res.set_icon("./assets/pine64logo.ico");
res.compile().unwrap();
}
}
================================================
FILE: docs/LICENSE
================================================
The GPLv2 License (GPLv2)
Copyright (c) 2022 Spagett1
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2, as published by
the Free Software Foundation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see 
Pineflash is a tool for updating the firmware on the Pinecil soldering irons.
Pineflash is a fully open source project, the only official download links are this site and the github page, do not download it from unofficial sources.