smarks: Smart Marks

#!/usr/bin/env python3 # smarks (Smart Marks): an HTML bookmark and RSS generator # # Copyright 2026 640kb.neocities.org # Blue Oak Model License 1.0.0 # # 25Aug2026: Initial public release import sys import os import json import xml.etree.ElementTree as ET from xml.dom import minidom from datetime import datetime # =========================================================================== # CONFIGURATION # =========================================================================== # TAG COLUMNS # ----------- # Letters A through SPLIT_LETTER go in the left column. # All letters after SPLIT_LETTER go in the right column. # # Example: # SPLIT_LETTER = 'K' # Left: A-K, Right: L-Z # SPLIT_LETTER = 'K' # =========================================================================== # CONFIGURATION: DIRECT EDITING # =========================================================================== # PAGE TITLE # ---------- # search for: smarks: Smart Marks # # Change the RSS feed title: # search for: ET.SubElement(channel, 'title').text = 'smarks: Smart Marks' # FOOTER LINKS # ------------ # search for:

# BOOKMARKS PER PAGE # ------------------ # To change, search for: var bookmarksPerPage = 20; # Middle Column Width Adjustment # ------------------------------ # In CSS: .container {width: 920px;} AND .content {width: 500px;} # Adjust both by the same amount # Tag Columns Width Adjustment # ---------------------------- # In CSS: .container {width: 920px;} AND .tag-column {width: 180px;} # Adjust 'container' by double the amount of tag-column changes # =========================================================================== def show_help(): print(""" .-------------------------------------------------------. | smarks (Smart Marks): an HTML bookmark, RSS generator | |-------------------------------------------------------| | Usage: smarks [output.html] | | | | Default output is bookmarks.html | |-------------------------------------------------------| | Examples: | | | | * smarks bookmarks.txt | | * smarks bookmarks.txt mypage.html | | * smarks path/to/bookmarks.txt anyName.html | |-------------------------------------------------------| | Configuration: | | Edit SPLIT_LETTER at the top of the script to | | adjust the distribution of tags. Example: | | | | SPLIT_LETTER = 'H' gives A-H and I-Z | | | | Other configuration options available | |-------------------------------------------------------| | See smarks.txt for details | '-------------------------------------------------------' """) def parse_bookmarks(filename): bookmarks = [] if not os.path.exists(filename): print(f"Error: File '{filename}' not found!") return None with open(filename, 'r', encoding='utf-8') as f: lines = [line.rstrip('\n') for line in f.readlines()] i = 0 while i < len(lines): if not lines[i] or lines[i].startswith('#'): i += 1 continue url = lines[i].strip() if not url: i += 1 continue i += 1 if i >= len(lines): break title = lines[i].strip() i += 1 if i >= len(lines): break description = lines[i].strip() i += 1 if i >= len(lines): break tags_line = lines[i].strip() tags = [tag.strip() for tag in tags_line.split(',') if tag.strip()] i += 1 bookmarks.append({ 'url': url, 'title': title, 'description': description, 'tags': tags, 'date_added': datetime.now().strftime('%Y-%m-%d %H:%M:%S') }) while i < len(lines) and (not lines[i] or lines[i].startswith('#')): i += 1 return bookmarks def generate_html(bookmarks): all_tags = set() for bm in bookmarks: for tag in bm['tags']: all_tags.add(tag) all_tags = sorted(list(all_tags)) tags_left = [] tags_right = [] for tag in all_tags: first_letter = tag[0].upper() if tag else '' if first_letter and first_letter <= SPLIT_LETTER: tags_left.append(tag) else: tags_right.append(tag) next_letter = chr(ord(SPLIT_LETTER) + 1) html_content = """ smarks: Smart Marks

A - {SPLIT_LETTER}

Latest bookmarks

""" + next_letter + """ - Z

""" return html_content def generate_rss(bookmarks): rss = ET.Element('rss', version='2.0') channel = ET.SubElement(rss, 'channel') ET.SubElement(channel, 'title').text = 'smarks: Smart Marks' ET.SubElement(channel, 'link').text = 'about:blank' ET.SubElement(channel, 'description').text = 'Latest bookmarks' ET.SubElement(channel, 'language').text = 'en-us' ET.SubElement(channel, 'lastBuildDate').text = datetime.now().strftime('%a, %d %b %Y %H:%M:%S GMT') last_10 = bookmarks[-10:] if len(bookmarks) >= 10 else bookmarks for bm in reversed(last_10): item = ET.SubElement(channel, 'item') ET.SubElement(item, 'title').text = bm['title'] ET.SubElement(item, 'link').text = bm['url'] description_text = bm['description'] if bm['tags']: description_text += f"

Tags: {', '.join(bm['tags'])}" ET.SubElement(item, 'description').text = description_text ET.SubElement(item, 'pubDate').text = datetime.now().strftime('%a, %d %b %Y %H:%M:%S GMT') ET.SubElement(item, 'guid').text = bm['url'] xml_str = minidom.parseString(ET.tostring(rss)).toprettyxml(indent=' ') return xml_str def main(): if len(sys.argv) < 2 or len(sys.argv) > 3: show_help() sys.exit(1) input_file = sys.argv[1] if len(sys.argv) == 3: output_file = sys.argv[2] if not output_file.endswith('.html'): output_file += '.html' else: output_file = 'bookmarks.html' print(f"\n Reading bookmarks from {input_file}...") bookmarks = parse_bookmarks(input_file) if bookmarks is None: sys.exit(1) if not bookmarks: print("Warning: No bookmarks found in file!") bookmarks = [] print(f" Found {len(bookmarks)} bookmarks") print(f"\n Generating {output_file}...") html_content = generate_html(bookmarks) with open(output_file, 'w', encoding='utf-8') as f: f.write(html_content) print(" Generating rss.xml...") rss_content = generate_rss(bookmarks) with open('rss.xml', 'w', encoding='utf-8') as f: f.write(rss_content) print("\n Done! Generated:") print(f" - {output_file}") print(" - rss.xml") print("") if __name__ == "__main__": main()