Skip to content

OpenBoardView/OpenBoardView

Repository files navigation

Open Board Viewer Build Status

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

Walkthrough of OpenBoardView R7.2

Demo Video

Common net pin halo

Part searching

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 groupinstall "Development Tools"

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

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