Skip to content

Repository for community provided Binary Ninja plugins

License

Notifications You must be signed in to change notification settings

lordidiot/community-plugins

This branch is 6 commits ahead of, 362 commits behind Vector35/community-plugins:master.

Repository files navigation

Binary Ninja Plugins

PluginName Author Last Updated License Type Description
ManticoreUI Trail of Bits 2022-07-26 AGPL-3.0 helper, ui Graphical user interface to interact with Manticore symbolic execution engine

Binary Ninja Community Plugins

Plugins in this repository are provided by the community. Vector 35, Inc. makes no guarantees to the quality, safety or efficacy of the plugins herein.

Official Plugins

This repository tracks third-party plugins, but many official plugins are provided by Vector 35 that offer additional functionality:

Installing Plugins

To install plugins, you can either use the Plugin Manager in the UI or clone the repositories linked here in into your plugin folder.

Contributing Plugins

  1. Create a new repository (Optionally, just copy it from the sample plugin)
  2. Fill out a plugin.json. Optionally you can use the generate_plugininfo.py -p to interactively walk you through setting the required fields. The plugin.json must pass all the checks when run through generate_plugininfo.py -v plugin.json. generate_plugininfo.py can also generate your README.md and your LICENSE file with the -r, -l, or -a (all) options. Below is a list of the required and recommended fields.
  3. Create and push a git tag with the version of your plugin (e.g. v1.1). Create a release, optionally attaching build artifacts as required. We recommend using our release helper which simplifies this process.
  4. File an issue with a link to your repo.
  5. To update your plugin, simply do a new release! For future updates we'll automatically detect and add the new release to the plugin manager for you! (This previously was a manual step that has been since automated)

Required Fields

To be displayed in the plugin loader, your plugin.json MUST have the following fields:

  • pluginmetadataversion - The current version is the integer 2
  • name - Good names do not use "Binary Ninja" or "Binja" neither do they use the words "plugin" or "extension". So instead of "Binja 6502 Architecture Plugin" simply use "6502 Architecture"
  • author - Your name, handle, or company name.
  • api - A list of supported architectures. Currently only python3 is supported.
  • license - A json object with name and text keys.
  • description - This is a short (<50 character) description of the plugin.
  • version - Version string
  • minimumBinaryNinjaVersion - An integer build number so instead of 1.1.555 use 555.
  • platforms - A list of strings one for each supported platform. Valid platforms are Darwin, Linux, and Windows

Recommended Fields

  • longdescription - A longer Markdown formatted description of the plugin including hyperlinks and images as needed. This will be shown in the plugin preview in the plugin manager and images are highly recommended. If not specified or if empty, the README file from your repository will be automatically used instead.
  • type - A list of strings of the following types: core, ui, architecture, binaryview, and helper.
    • helper - Plugin that adds some base functionality to Binary Ninja. Most plugins will be of this type.
    • ui - The plugin extends the UI is some way.
    • architecture - The plugin adds an architecture (e.g. x86, ARM, MIPS).
    • binaryview - The plugin adds a new BinaryView (e.g. PE, MachO, ELF).
    • core - Plugin that extends the core's analysis. Your plugin probably isn't one of these.
  • installinstructions - A json object with keys for each supported platform listed in platforms and text Markdown formatted.

License

Note that content contained in the root of this repository itself is Copyright 2016, Vector 35, Inc. and available under an MIT license, but each individual plugin may be released under a different license.

About

Repository for community provided Binary Ninja plugins

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%