Skip to content
No description, website, or topics provided.
C++ QML CMake C
Branch: qml
Clone or download

Latest commit

maxnet Performance improvements
- Use larger buffer size when writing uncompressed files
  (was libcurl's default of 16 kb, change it to 128 kb)
- Uncompress the next MB of data, while it is hashing/writing to
  disk in seperate thread.
Latest commit 0264af9 Mar 10, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
debian Performance improvements Mar 10, 2020
dependencies Qt/QML edition Mar 4, 2020
fonts Qt/QML edition Mar 4, 2020
icons Rename imagingutility -> rpi-imager Mar 5, 2020
linux Rename imagingutility -> rpi-imager Mar 5, 2020
mac Qt/QML edition Mar 4, 2020
windows Mention version number in title bar Mar 10, 2020
CMakeLists.txt Mention version number in title bar Mar 10, 2020
README.md README.md: update repo imagewriter -> rpi-imager Mar 9, 2020
config.h Performance improvements Mar 10, 2020
downloadextractthread.cpp Performance improvements Mar 10, 2020
downloadextractthread.h Performance improvements Mar 10, 2020
downloadthread.cpp Performance improvements Mar 10, 2020
downloadthread.h Performance improvements Mar 10, 2020
driveformatthread.cpp Qt/QML edition Mar 4, 2020
driveformatthread.h Qt/QML edition Mar 4, 2020
drivelistitem.cpp Qt/QML edition Mar 4, 2020
drivelistitem.h Qt/QML edition Mar 4, 2020
drivelistmodel.cpp Qt/QML edition Mar 4, 2020
drivelistmodel.h Qt/QML edition Mar 4, 2020
imagewriter.cpp Performance improvements Mar 10, 2020
imagewriter.h Mention version number in title bar Mar 10, 2020
license.txt Qt/QML edition Mar 4, 2020
main.cpp Mention version number in title bar Mar 10, 2020
main.qml Mention version number in title bar Mar 10, 2020
nan.h Qt/QML edition Mar 4, 2020
networkaccessmanagerfactory.cpp Qt/QML edition Mar 4, 2020
networkaccessmanagerfactory.h Qt/QML edition Mar 4, 2020
powersaveblocker.cpp Qt/QML edition Mar 4, 2020
powersaveblocker.h Qt/QML edition Mar 4, 2020
qml.qrc Rename imagingutility -> rpi-imager Mar 5, 2020
qtquickcontrols2.conf Qt/QML edition Mar 4, 2020

README.md

rpi-imager

Raspberry Pi Imaging Utility

License

The main code of the Imaging Utility is made available under the terms of the Apache license. See license.txt and files in "dependencies" folder for more information about the various open source licenses that apply to the third-party dependencies used such as Qt, libarchive, drivelist, mountutils and libcurl.

How to rebuild

Debian/Ubuntu Linux

Get dependencies

Install the build dependencies:

sudo apt install --no-install-recommends build-essential devscripts debhelper cmake git libarchive-dev libcurl4-openssl-dev \
    qtbase5-dev qtbase5-dev-tools qtdeclarative5-dev \
    qml-module-qtquick2 qml-module-qtquick-controls2 qml-module-qt-labs-settings qml-module-qtquick-layouts qml-module-qtquick-templates2 qml-module-qtquick-window2 qml-module-qtgraphicaleffects

Get the source

git clone --depth 1 https://github.com/raspberrypi/rpi-imager

Build the Debian package

cd rpi-imager
debuild -uc -us

debuild will compile everything, create a .deb package and put it in the parent directory. Can install it with apt:

cd ..
sudo apt install ./rpi-imager*.deb

It should create an icon in the start menu under "Utilities" or "Accessories". The imaging utility will normally be run as regular user, and will call udisks2 over DBus to perform privileged operations like opening the disk device for writing. If udisks2 is not functional on your Linux distribution, you can alternatively start it as "root" with sudo and similar tools.

Windows

Get dependencies

  • Get the Qt online installer from: https://www.qt.io/download-open-source During installation, choose a Qt 5.x with Mingw32 32-bit toolchain and CMake.

  • If using the official Qt distribution that does NOT have schannel (Windows native SSL library) support, compile OpenSSL libraries ( https://wiki.qt.io/Compiling_OpenSSL_with_MinGW ) and copy the libssl/crypto DLLs to C:\qt\5.x\mingw73_32\bin

  • For building installer get Nullsoft scriptable install system: https://nsis.sourceforge.io/Download

  • It is assumed you already have a proper code signing certificate, and signtool.exe from the Windows SDK installed. If NOT and are you only compiling for your own personal use, comment out all lines mentioning signtool from CMakelists.txt and the .nsi installer script.

Building

Building can be done manually using the command-line, using "cmake", "make", etc., but if you are not that familar with setting up a proper Windows build environment (setting paths, etc.), it is easiest to use the Qt creator GUI instead.

  • Download source .zip from github and extract it to a folder on disk
  • Open CMakeLists.txt in Qt creator.
  • For builds you distribute to others, make sure you choose "Release" in the toolchain settings and not the debug flavour.
  • Menu "Build" -> "Build all"
  • Result will be in ../build_rpi-imager_someversion
  • Go to the BUILD folder, right click on the .nsi script "Compile NSIS script", to create installer.

Note: the CMake integration in Qt Creator is a bit flaky at times. If you made any custom changes to the CMakeLists.txt file and it subsequently gets in an endless loop where it never finishes the "configures" stage while re-processing the file, delete "build_rpi-imager_someversion" directory and try again.

Mac OS X

Get dependencies

  • Get the Qt online installer from: https://www.qt.io/download-open-source During installation, choose a Qt 5.x edition and CMake.
  • For creating a .DMG for distribution you can use an utility like: https://github.com/sindresorhus/create-dmg
  • It is assumed you have an Apple developer subscription, and already have a "Developer ID" code signing certificate for distribution outside the Mac Store. (Privileged apps are not allowed in the Mac store)

Building

  • Download source .zip from github and extract it to a folder on disk
  • Start Qt Creator (may need to start "finder" navigate to home folder using the "Go" menu, and find Qt folder to start it manually as it may not have created icon in Applications), and open CMakeLists.txt
  • Menu "Build" -> "Build all"
  • Result will be in ../build_rpi-imager_someversion
  • For distribution to others: code sign the .app, create a DMG, code sign the DMG, submit it for notarization to Apple and staple the notarization ticket to the DMG.

E.g.:

cd build-rpi-imager-Desktop_Qt_5_14_1_clang_64bit-Release/
codesign --deep --force --verify --verbose --sign "YOUR KEYID" --options runtime rpi-imager.app
mv rpi-imager.app "Raspberry Pi Imager.app"
create-dmg Raspberry\ Pi\ Imager.app
mv Raspberry\ Pi\ Imager\ .dmg imager.dmg
xcrun altool --notarize-app -t osx -f imager.dmg --primary-bundle-id="org.raspberrypi.imagingutility" -u YOUR-EMAIL-ADDRESS -p YOUR-APP-SPECIFIC-APPLE-PASSWORD -itc_provider TEAM-ID-IF-APPLICABLE
xcrun stapler staple imager.dmg

Other notes

Debugging

On Linux and Mac the application will print debug messages to console by default if started from console. On Windows start the application with the command-line option --debug to let it open a console window.

Custom repository

If the application is started with "--repo [your own URL]" it will use a custom image repository. So can simply create another 'start menu shortcut' to the application with that parameter to use the application with your own images.

You can’t perform that action at this time.