ve3lst/thome

a simple static dashboard

THome

THome is a static minimal personal dashboard made for local use, except its a bit easier to maintain and update it using python

I just wanted to make my own dashboard for my homelab and used the things i know to put it together as simple as i can

Features

• simple design
• responsive, works great on PC, tablet and phone
• doesn't require any special dependencies, for linux at least
• has search to filter your cards
• works fast and perfectly without internet, since all the css and js are attached

Screenshots

requirement

• A Text Editor
• Python
• Web Browser

How to use

• First of edit the sites.xml, change every thing in CAPS, add as many as you like

<item name = "NAME">
    <tag>TAG</tag>
    <tag_text>SHORT_TAG</tag_text>
    <name>NAME</name>
    <link>HTTPS://LINK.COM</link>
    <image_name>FILENAME.PNG</image_name>
    <powered_by>NAME</powered_by>
    <description_en>TEXT</description_en>
    <description_ar>نص</description_ar>
</item>

• for <tag> use the folowing categories or however you like (this affect the colors of the cards):

  • "KB" Stands for: Knowledge Base and Wikis
  • "SaM" Stands for: Social networks and media
  • "WaB" Stands for: Websites and Blogs
  • "SaI" Stands for: Search and Indexing
  • "admin" Stands for: Admin tools and such

• Run the python script to create your index.html python main.py

• put the files in your webserver or just open it in your web browser

Used stuff

things used here:

• HTML
• CSS
• Bootstrap & jQuery
• This script for the search
• Nord Colors
• Python

TO DO

• well, I just realized not everyone needs a dual langage cards. so I will try to make it flexible to pick mono-lang or dual-lang
• make CLI for the python script, maybe

thome's Issues

Error with long complex link

I ran across a minor issue with a long complex link.

https://app.rockgympro.com/b/widget/?a=offering&offering_guid=27bfb7a0288743b5d1291c6b09762e27&random=5bd455ac38eda&iframeid=&mode=p That link is an example, but not a working link. To test so far, in debug it identifies: not well-formed (invalid token): line 88, column 75 File "U:\VSCode-projects\Web\Dashboard\THome\main.py", line 6, in tree = ET.parse("sites.xml") That is the row above. Col 75 is the "i" in guid, so I'm going to guess that it is a length issue of being over 75 isn't working with the parser. I know it isn't the URL as I paste the URL into the resulting index.html and the button works fine. It is probably going to be very rare to have a href that exceeds 75 characters, but if I find the problem and/or fix, I will post it.

Cheers and thanks,
Mel