nanoFrameworkDeployer 1.1.140-gd1fb97f949

This is a prerelease version of nanoFrameworkDeployer.
dotnet add package nanoFrameworkDeployer --version 1.1.140-gd1fb97f949
NuGet\Install-Package nanoFrameworkDeployer -Version 1.1.140-gd1fb97f949
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFrameworkDeployer" Version="1.1.140-gd1fb97f949" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFrameworkDeployer --version 1.1.140-gd1fb97f949
#r "nuget: nanoFrameworkDeployer, 1.1.140-gd1fb97f949"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install nanoFrameworkDeployer as a Cake Addin
#addin nuget:?package=nanoFrameworkDeployer&version=1.1.140-gd1fb97f949&prerelease

// Install nanoFrameworkDeployer as a Cake Tool
#tool nuget:?package=nanoFrameworkDeployer&version=1.1.140-gd1fb97f949&prerelease

Quality Gate Status Reliability Rating Build Status NuGet License #yourfirstpr Discord

nanoFramework logo

Cross-platform .NET nanoFrameworkDeployer Console Application

This repo provides a .NET Console Application that can deploy your .NET nanoFramework projects to a nanoFramework supported device connected via USB. While this is already possible through the nanoFramework extension in Visual Studio for Windows, this repository aims to add support for deploying your projects on non-Windows based devices such as macOS and Linux.



Linux / macOS

  • mono-complete on non Windows platforms, you can find out how to install mono here. The reason that you need mono is because the tool requires .NET 4.7.2. This tool cannot yet be build using .NET 6.0 or .NET Core because some of the dependencies are those used by the Visual Studio extension. The other reason why you need mono is to build a nanoFramework project.

Getting Started

The tool provide various options:

  -d, --directory    Required. Folder containing the PE files.
  -v, --verbose      Show verbose messages.
  -c, --comport      The COM port to use if multiple. By default, the first
                     valid found is used.
  -e, --exception    COM Port exception file.
  -r, --reboot       Reboot the device after flash.
  -b, --bin          Creates a deployment binary file only. This is not attempting to deploy.
  --help             Display this help screen.
  --version          Display version information.

NOTE: When running this tool in a NON Windows environment, you need to use mono. If you are using Windows 7 or above, you DO NOT need mono .

You can then use commands like:

Linux / macOS

mono nanoFrameworkDeployer -d path_to_pe_files

path_to_pe_files is the path to the build folder where all the .pe files are located. Note that the tool will automatically upload all the .pe files available in that folder.

Excluding a COM port

Some virtual COM ports are provided by Bluetooth devices and other software. By default the tool will scan all the possible mounted COM ports to try to find a valid .NET nanoFramework device. That can disconnect temporally your connected headset or any other device using a COM port and may also cause lockups in the deployer tool. In that case, you can create an exclusion file. Just list the COM ports you want to exclude from the search, one port per line. You can then use the -e option to pass the name of the file.


Rebooting the device once flashed

You can automatically ask the tool to reboot your device once flashed, used the -r options for that.

Selecting a specific COM port

If you have multiple valid .NET nanoFramework devices connected, you can select a specific COM port, just use the -c option to specify that followed by the COM port you want to use.

Creating a binary deployment file

Using the --bin or -b option will create a binary deployment file. You can then use it with nanoff to flash your device. Please note that using this option will not flash the device. All other options except the directory one will be ignored.

Feedback and documentation

For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.

Join our Discord community here.


The list of contributors to this project can be found at CONTRIBUTORS.


The nanoFramework Class Libraries are licensed under the MIT license.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behaviour in our community. For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.

Product Compatible and additional computed target framework versions.
.NET Framework net472 is compatible.  net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.140-gd1fb97f949 166 12/5/2022
1.1.44 177 5/12/2023
1.1.43 176 4/27/2023
1.1.42 172 4/26/2023
1.1.41 192 4/13/2023
1.1.40 183 4/12/2023
1.1.39 224 3/10/2023
1.1.38 238 2/20/2023
1.1.26 460 8/19/2022
1.1.24 370 8/8/2022
1.1.23 411 5/12/2022
1.1.22 417 4/19/2022
1.1.18 121 4/18/2022
1.1.14 119 3/23/2022
1.1.11 120 3/22/2022
1.1.5 162 12/21/2021
1.1.1 162 12/16/2021
1.0.23 151 12/16/2021
1.0.19 152 11/17/2021
1.0.17 153 11/16/2021
1.0.16 161 11/16/2021
1.0.11 184 9/28/2021
1.0.9 197 9/28/2021
1.0.7 141 9/28/2021