freifunk / device-pictures

Includes vector graphics of routers supported by openwrt (and gluon)
Other
4 stars 3 forks source link

Device Pictures

This repository contains vector graphics of routers used in the Gluon-Firmware-Selector and in the Meshviewer. It can be equally used for OpenWRT Firmware selectors and the like.

This unifies the valuable work started by Daniel Krah, Julian Labus, Jan Alexander and freifunkstuff.

The pictures are available under CC-BY-NC-SA 4.0, with exceptions. Any such exception is marked with a cc:License or cc:license tag within the respective SVG file or as metadata within the PNG or JPG files.

Creating JPG and PNG

To create jpg and png files, you need to have imagemagick and inkscape installed. Rune

./conversion-script.sh

Output is written to pictures-png and pictures-jpg respectively.

Symlinks

This repository symlinks version aliases instead of creating additional files. Initially this was checked using fdupes.

The Gluon Autoupdater looks for the Model Name in the manifest (except for raspberry pi, where the board name is used). The meshviewer receives the data from respondd through an aggregator like yanic, and therefore needs the whole Model Name too.

The firmware selector does cut off version related parts and looks for a picture without versions specified to show. Therefore, multiple symlinks are created in the conversion-script.sh which take care of this.

For some devices, the Model name has been corrected in Openwrt throughout releases, which introduced a change and requires to keep an alias for the new name, as both versions may appear on a meshviewer (one with more recent firmware and one with less recent firmware).

Installation

After creating the pictures-jpg and pictures-svg folder with symlinks, you can serve them through http to your liking.

In meshviewer you can add hwImages to your config.json:

    "hwImg": "https://map.aachen.freifunk.net/pictures-svg/{MODEL_NORMALIZED}.svg",

In the firmware-selector you can add

  preview_pictures: 'https://map.aachen.freifunk.net/pictures-jpg/',

to use the updated central source of jpg files.