OpenBoardView

Open Board Viewer

Linux SDL/ImGui edition software for viewing .brd files, intended as a drop-in replacement for the "Test_Link" software and "Landrex".

Features

• Annotations (per board database file)
• Part and pin sizes better represented
• Better outlining of irregular objects (such as connectors)
• Drag and drop
• Recently used file history
• Non-orthagonally orientated caps/resistors/diodes now drawn more realistically
• Adjustable DPI (for working on 2K/4K screens)
• Works with multiple concurrent instances

TODO

• Decode more board formats
• Compound project/file format

Prerequisites

macOS

$ brew install cmake sdl2

If you get the following error after running build.sh:

urllib.error.URLError: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:997)>

Run the script at /Applications/Python3.x/Install Certificates.command.

Ubuntu

For Ubuntu developers, you'll need the following packages at a minimum;

$ apt-get install git build-essential cmake libsdl2-dev libgtk-3-dev

Fedora

For Fedora, you will need the following packages at a minimum;

$ dnf install @development-tools

$ dnf install SDL2-devel gtk3-devel fontconfig-devel cmake

Installation

1. Clone the project

$ git clone --recursive 'https://github.com/OpenBoardView/OpenBoardView'

1. Build it

$ ./build.sh

1. Sign it (skip if you're not on running macOS)

$ codesign --force --deep --sign - ./openboardview.app

1. Run it!

$ ./bin/openboardview

...or...

$ ./openboardview.sh

...or...

$ open ./openboardview.app

Usage

• Ctrl-O: Open file select dialog

• w/a/s/d: pan viewport over board

• x: Reset zoom and center

• Mouse scroll, -/=: Zoom out/in

• Mouse click-hold-drag, Numeric pad up/down/left/right: pan viewport over board

• Numeric pad +/-: zoom board

• Numeric pad 5: Reset zoom and center

• Space, Middle mouse click: Flip board

• R/./Numpad-Del: Rotate clockwise

• ,/Numpad-Ins: Rotate counter-clockwise

• /, Ctrl-F: Search

• ESC: Clear search results and selected parts

• p: Toggle pin display

• m: Mirror board across Y-axis

• L: Show net list

• K: Show part list