Skip to content

VA3HDL/hamdashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Original VA3HDL YouTube - Presentation video

VA3HDL en español YouTube - Video en español

Hamdash Demo -- Test it here before download

User submitted live Dashboards:

BCAT N4TDX -- by Steve N5NG, in use by the Brevard County (Florida) ARES Team

FFX DEMS -- by Sandy KQ4DNE for Emergency Management Weather

FFX ARES -- by Sandy KQ4DNE for ARES

WA4MED -- by Matthew WA4MED

PY3TX -- South America

VE7CAS -- Vancouver, BC

OK1SLM -- Prague, EU

K6BCW -- San Francisco bay area

KN6PTQ -- San Francisco Bay Area

W2SZ -- NE US by Brian W2SZ

N2YQT -- NE US by Ryan N2YQT

KC2VWR -- NE US

KD2YFY -- NE US

KD4VRD -- North Carolina

KD5PQJ -- Texas

N5GAH -- Texas

KJ7YYI -- Arizona

NQ0M -- Kansas

W3RDW -- Ohio

W4QAL -- SE US - West Florida

Instructions:

  1. Just download the files from the Github repository (hamdash.html, config.js, and wheelzoom.js) and keep them together on the same folder.
  2. Open hamdash.html with any browser of your preference and you done.
  3. With any text editor (like Notepad) you can change the source images (can be more than one per box) or the menu options from the config.js file.

YouTube coverage:

YouTube - Configuration instructions contributed by Jason KM4ACK

YouTube - Raspberry Pi instructions contributed by Andreas M0FXB

YouTube - Live Stream with Ham Radio Wilderness Frank KG6NLW

YouTube - Live Stream with Temporarily Offline Ham Radio KM9G

YouTube - Ham Dashboard on Inovato Quadra by Peter KJ5AJB

YouTube - French review and instructions by Jean-Benard F5SVP

YouTube - Repaso e instrucciones en Español con Jose EA8EE

Docker:

Docker version -- by Michael Stevens

Quick Help:

  • Double click on an image to expand to full screen.
  • Double click again to close full screen view.
  • Right click on an image to display the next one. (In the latest version is possible to add multiple images per box.)
  • The content refreshes automatically every 5 minutes.

Is that easy!

73 de Pablo, VA3HDL

Fix for Pi-Star iFrame embedding issues:

This error can occur if the server has certain security measures in place, such as the x-frame-options header, which prevents its content from being embedded on other websites using iframes.

  1. Login via ssh to the pi-star then run this command to switch to Read/Write mode:

     rpi-rw
    
  2. Edit the file nginx security.conf file:

     sudo nano /etc/nginx/default.d/security.conf
    
  3. comment the line below with a "#" in front, like this:

     # add_header X-Frame-Options  "SAMEORIGIN";
    
  4. Run this command to switch back to Read Only mode:

     rpi-ro
    
  5. Now you can either reboot your Pi-Star, or just restart the nginx service:

     sudo systemctl restart nginx.service
    

More on iFrame embedding:

There is very little that can be done on the client side if the source site does not allow embedding the site inside another page (like the dashboard!) specially if the user can't change the server settings (most cases.)

As a workaround for these issues, I've tested running a local proxy on my computer to strip out the x-frame-options header coming from the source server and it worked well on some cases. But setting up a proxy adds another layer of complexity to the setup.

Use this online tool to test any URL to see if it can be displayed in an iframe before adding it to the dashboard -> iFrame Tester online

Updates

If you want to upgrade to the latest version, the only file you need to update is hamdash.html (do not overwrite your config.js file.)

Check updated demo!

2024.11.13 Changelog:

  • Added capability to customize the grid size (any combination of number of columns and number of rows for the dashboard tiles.) See examples and usage below.
  • Removed "VA3HDL" from the page title.
  • Grid size examples:

--> 2x2:

--> 3x3:

--> 4x4:

--> 5x3:

  • Usage: Add these lines to your config.js file

      // Grid layout
      var layout_cols = 4;
      var layout_rows = 3;
    

2024.10.16 Changelog:

  • Added website capability to tiles using "iframe|" keyword before the tile URL. Check the updated config.js file for usage examples. The tiles can contain any website that supports embedding using iFrame, including live YouTube videos!

2024.07.24 Changelog:

2024.07.06 Changelog:

  • Add version check and minor fixes.

2024.07.05 Changelog:

  • Removed 5 minutes page autorefresh. Now all tiles refresh separatelly (at same or different intervals.) So there is no longer needed refresh the entire page.

2024.07.04 Changelog:

  • Full screen images will rotate with mouse right click (when there is more than one image on the selected tile)

  • Added the ability to set individual image rotation at different intervals per tile adding a line like this at the end of the config.js file:

      const tileDelay = [5000,4000,3000,2000,1000,6000,7000,8000,9000,8500,7500,6500];
    

2024.06.12 Changelog:

  • Added menu option (right side menu) to display on screen the various sources for images and menu options to facilitate sharing URL sources in our user community

2024.06.08 Changelog:

  • Added support to play videos (along with the images.) Some modernized sites provide .mp4 videos instead of animated GIFS.

2024.06.05 Changelog:

  • Added image loading error handling
  • Added workaround to prevent images being cached on the browser and not getting updated

2024.05.27 Changelog:

  • Moved the configuration parts of the JavaScript code to its own file "config.js" so it is easy to upgrade after updates to the main code. Suggested by Lou KI5FTY.
  • Improved menu usability

2024.05.25 Changelog:

  • Removed dependencies to local installed fonts. Fonts now are loaded from Google Fonts directly to ensure consistency.
  • Ability to add multiple images per position. Images are rotated automatically every 30 seconds.
  • Autorefresh is now paused automatically when switching to a website (from menu) or when an image is zoomed-in to full screen
  • Moved configuration variables to the top of the script and added extra commentary to ease the initial setup
  • Added menu to the right of the page. Now the left menu has ham radio links and right menu has weather links

Host your dashboard with Cloudflare Pages, free

Tutorial contributed by Robert W3RDW

How to host your dashboard with Cloudflare Pages, free

Samples

VA3HDL Sample Dashboard

N4NBC Sample Dashboard

KM4ACK Sample Dashboard

TI3GB Sample Dashboard

N5NG Sample Dashboard

VK3MLT Sample Dashboard

VK5TUX Sample Dashboard

VK5TUX Sample Dashboard Sources

N4TDX Sample Dashboard

WG5EEK Sample Dashboard

KJ5FMX Sample Dashboard

N0RMJ Sample Dashboard

N5GAH Sample Dashboard

OES MarTech Sample Dashboard

TheSky Sample Dashboard

KJ7T Sample Dashboard

K4HNH Sample Dashboard

CT1ETE Sample Dashboard

VK3FS Sample Dashboard

W5EAK Sample Dashboard

WI5L Sample Dashboard

WX9WTF Sample Dashboard

Dual menu example:

Dual side Menu Sample Dashboard

Sources display example:

Sources display example