Skip to main content
angr Management is highly customizable through its comprehensive preferences system. This guide covers all available configuration options.

​
Accessing Preferences

Open the preferences dialog:
  • File → Preferences
  • Or press Ctrl+, (on most platforms)

​
General Settings

​
User Interface

UI Default FontControls font used for:
  • Menu items
  • Dialog boxes
  • Table views
  • General UI text
Default: System fontTo change:
  1. Click font selector
  2. Choose font family
  3. Set size
  4. Select weight
Font for TablesUsed in:
  • Functions table
  • Breakpoints table
  • Patches table
  • String tables
Recommendation: Monospace font for alignment

​
Theme

Choose a color scheme:
Classic light theme (default)
  • Light backgrounds
  • Dark text
  • Suitable for bright environments
  • Easy on eyes in daylight

​
Disassembly Settings

​
Fonts

Disassembly Font: Font used in the disassembly view 
# Monospace fonts work best:
- DejaVu Sans Mono
- Source Code Pro
- Consolas (Windows)
- Monaco (macOS)
- JetBrains Mono
- Fira Code
Size Recommendations:
  • Small screens: 10-11pt
  • Standard: 11-12pt
  • Large screens: 12-14pt
  • Presentations: 14-16pt

​
Colors

Customize syntax highlighting colors:
  • Mnemonic: Instruction name color
  • Operands: Operand color
  • Constants: Immediate values
  • Variables: Variable names
  • Comments: Comment text

​
Display Options

Node Rounding

Adjust corner rounding on graph nodes:
  • 0: Sharp corners
  • 5-10: Slightly rounded (recommended)
  • 15+: Very rounded

Minimap Colors

Configure minimap appearance:
  • Background color
  • Viewport indicator
  • Shadow color
  • Outline color

​
Pseudocode Settings

​
Font

Code Font: Font for pseudocode view Recommended monospace fonts:
  • Source Code Pro (default)
  • Fira Code (with ligatures)
  • JetBrains Mono
  • Cascadia Code

​
Syntax Highlighting

Customize pseudocode colors:
ElementConfigurableExample
KeywordsColor, Weight, Styleif, while, return
TypesColor, Weight, Styleint, char*
FunctionsColor, Weight, Stylefunc_401000()
Library FunctionsColorprintf()
VariablesColor, Weight, Stylelocal_var
Global VariablesColor, Weight, Styleg_data
CommentsColor, Weight, Style// comment
StringsColor, Weight, Style"string"
LabelsColor, Weight, Stylelabel_1:
Font Weights:
  • Light
  • Normal/Medium (default)
  • DemiBold
  • Bold
Font Styles:
  • Normal (default)
  • Italic
  • Oblique

​
Highlight Color

Pseudocode Highlight Color: Background color when selecting code elements Default: Yellow (#FFFF00)

​
Hex View Settings

​
Colors

  • Selection: Primary selection color (red)
  • Selection Alt: Inactive selection (gray)
  • Data: Generic data color
  • Strings: String data color
  • Instructions: Code bytes color

​
LLM Configuration

AI features require an OpenAI-compatible API endpoint.

​
API Settings

1

Model Selection

LLM Model: Model name (e.g., gpt-4, gpt-3.5-turbo)
2

API Key

LLM API Key: Your API key for authentication
Keep your API key secure. Don’t share your configuration file.
3

API Base URL

LLM API Base: Custom endpoint (optional)Default: OpenAI endpointCustom: For local models or alternative providers

​
Auto-Refinement

Enable automatic AI improvements:
Auto-rename Variables
  • Automatically suggests variable names
  • Runs on every decompilation
  • Can slow down analysis
Recommended: Off (use manual refinement)

​
Callee Preloading

Preload Callees: Load callee function information for context
  • Improves AI suggestions
  • Increases API usage
  • Slower but more accurate

​
Network Settings

​
Proxy Configuration

HTTP Proxy

Set proxy for HTTP requests:Format: http://proxy:portUsed for:
  • Downloading files
  • Plugin updates
  • API requests (if not HTTPS)

HTTPS Proxy

Set proxy for HTTPS requests:Format: https://proxy:portUsed for:
  • Secure downloads
  • LLM API requests
  • Plugin repositories

​
Analysis Settings

​
FLIRT Signatures

Signatures Root: Path to FLIRT signature files Default: ./angrmanagement/resources/flirt_signatures/ Custom signatures:
  1. Add .sig files to a directory
  2. Set this path to that directory
  3. Restart angr Management

​
Library Documentation

Docs Root: Path to library documentation files Default: ./angrmanagement/resources/library_docs/ Format: JSON files with function documentation

​
Plugin Settings

​
Plugin Search Path

Plugin Search Path: Colon-separated list of directories Default: $AM_BUILTIN_PLUGINS:~/.local/share/angr-management/plugins Components:
  • $AM_BUILTIN_PLUGINS: Built-in plugins
  • User plugin directory: Custom plugins

​
Enabled Plugins

Enabled Plugins: Comma-separated list of plugin names Example: 
MyPlugin,AnotherPlugin,ThirdPlugin
Empty: All discovered plugins enabled

​
Advanced Settings

​
Daemon Mode

Use Daemon: Run angr in daemon mode
Daemon mode runs angr analyses in a separate process:Benefits:
  • Shared analysis across multiple GUI instances
  • Faster startup for subsequent instances
  • Better resource isolation
Drawbacks:
  • Additional process overhead
  • Requires daemon management
  • More complex debugging
Recommended: Off for single-user scenarios

​
View Tabs

Enabled Tabs: Comma-separated list of view class names Default: Empty (all views enabled) Example (minimal setup): 
DisassemblyView,CodeView,FunctionsView,HexView

​
URL Scheme

URL Scheme Registration: Register angr:// protocol handler Enables:
  • Deep linking from browsers
  • Click angr:// links to open in angr Management
  • Integration with external tools
Platform support:
  • ✅ Linux
  • ✅ macOS
  • ✅ Windows

​
Configuration File

angr Management stores preferences in a TOML file: Location:
  • Linux: ~/.config/angr-management/config.toml
  • macOS: ~/Library/Application Support/angr-management/config.toml
  • Windows: %APPDATA%\angr-management\config.toml

​
Manual Editing

Edit configuration files at your own risk. Invalid TOML will prevent angr Management from starting.
Example configuration: 
theme_name = "Dark"
base_theme_name = "Dark"

[disasm_font]
family = "DejaVu Sans Mono"
size = 11
weight = 50

[code_font]
family = "Source Code Pro"
size = 11
weight = 50

[llm]
model = "gpt-4"
api_key = "sk-..."
auto_rename_variables = false
auto_summarize = true

​
Color Format

Colors are stored as ARGB hex strings: 
palette_highlight = "ff308cc6"  # ARGB: ff=alpha, 30=red, 8c=green, c6=blue

​
Importing/Exporting Settings

​
Export Configuration

  1. Locate your config file (see above)
  2. Copy to backup location
  3. Share with team or across machines

​
Import Configuration

1

Close angr Management

Exit all instances
2

Replace Config

Copy your config file to the correct location
3

Start angr Management

New settings take effect immediately

​
Reset to Defaults

  1. Close angr Management
  2. Delete or rename config.toml
  3. Restart angr Management
  4. Default configuration is created

​
Troubleshooting

Changes revert after restart:Causes:
  • File permissions issue
  • Config directory doesn’t exist
  • Corrupted config file
Solutions:
  • Check file permissions on config directory
  • Manually create config directory
  • Delete config file and restart
After changing theme or fonts:Solutions:
  • Restart angr Management
  • Reset to default theme
  • Check font is installed on system
  • Try different font/theme combination
AI features fail or timeout:Solutions:
  • Verify API key is correct
  • Check API base URL
  • Test API endpoint independently
  • Check network/proxy settings
  • Verify quota/rate limits

​
Performance Tuning

Large Binaries

For binaries >10MB:
  • Disable auto-decompilation
  • Disable minimap if slow
  • Use linear view more
  • Reduce graph node rounding
  • Limit enabled views

Low-End Hardware

Optimize for performance:
  • Disable AI auto-refinement
  • Use simpler color schemes
  • Reduce font sizes slightly
  • Disable exception edges
  • Close unused views

​
Next Steps

Interface

Return to interface overview

Themes

Create custom themes

Plugins

Extend with plugins

Scripting

Automate with scripts

Build docs developers (and LLMs) love

Get started for freeTalk to us