#!/usr/bin/env python3 # wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add - # sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list' # apt update; apt install google-chrome-beta import re import os import sys import json from datetime import datetime import time from subprocess import run, PIPE, DEVNULL ### SETTINGS INDEX_TEMPLATE = 'index_template.html' # os.getenv('VARIABLE', 'DEFAULT') gets the value of environment # variable "VARIABLE" and if it is not set, sets it to 'DEFAULT' # for boolean values, check to see if the string is 'true', and # if so, the python variable will be True FETCH_WGET = os.getenv('FETCH_WGET', 'True' ).lower() == 'true' FETCH_PDF = os.getenv('FETCH_PDF', 'True' ).lower() == 'true' FETCH_SCREENSHOT = os.getenv('FETCH_SCREENSHOT', 'True' ).lower() == 'true' RESOLUTION = os.getenv('RESOLUTION', '1440,900' ) # screenshot resolution FETCH_FAVICON = os.getenv('FETCH_FAVICON', 'True' ).lower() == 'true' SUBMIT_ARCHIVE_DOT_ORG = os.getenv('SUBMIT_ARCHIVE_DOT_ORG', 'True' ).lower() == 'true' ARCHIVE_PERMISSIONS = os.getenv('ARCHIVE_PERMISSIONS', '755' ) CHROME_BINARY = os.getenv('CHROME_BINARY', 'google-chrome') # change to chromium browser if using chromium WGET_BINARY = os.getenv('WGET_BINARY', 'wget' ) def check_dependencies(): print('[*] Checking Dependencies:') if FETCH_PDF or FETCH_SCREENSHOT: if run(['which', CHROME_BINARY]).returncode: print('[X] Missing dependency: {}'.format(CHROME_BINARY)) print(' See https://github.com/pirate/bookmark-archiver for help.') raise SystemExit(1) # parse chrome --version e.g. Google Chrome 61.0.3114.0 canary / Chromium 59.0.3029.110 built on Ubuntu, running on Ubuntu 16.04 result = run([CHROME_BINARY, '--version'], stdout=PIPE) version = result.stdout.decode('utf-8').replace('Google Chrome ', '').replace('Chromium ', '').split(' ', 1)[0].split('.', 1)[0] # TODO: regex might be better if int(version) < 59: print('[X] Chrome version must be 59 or greater for headless PDF and screenshot saving') print(' See https://github.com/pirate/bookmark-archiver for help.') raise SystemExit(1) if FETCH_WGET: if run(['which', 'wget']).returncode: print('[X] Missing dependency: wget') print(' See https://github.com/pirate/bookmark-archiver for help.') raise SystemExit(1) if FETCH_FAVICON or SUBMIT_ARCHIVE_DOT_ORG: if run(['which', 'curl']).returncode: print('[X] Missing dependency: curl') print(' See https://github.com/pirate/bookmark-archiver for help.') raise SystemExit(1) ### PARSING READER LIST EXPORTS def get_link_type(link): if link['base_url'].endswith('.pdf'): return 'PDF' elif link['base_url'].rsplit('.', 1) in ('pdf', 'png', 'jpg', 'jpeg', 'svg', 'bmp', 'gif', 'tiff', 'webp'): return 'image' elif 'wikipedia.org' in link['domain']: return 'wiki' elif 'youtube.com' in link['domain']: return 'youtube' return None def parse_pocket_export(html_file): html_file.seek(0) pattern = re.compile("^\\s*
  • (.+)
  • ", re.UNICODE) # see sample input in ./example_ril_export.html for line in html_file: match = pattern.search(line) if match: fixed_url = match.group(1).replace('http://www.readability.com/read?url=', '') # remove old readability prefixes to get original url without_scheme = fixed_url.replace('http://', '').replace('https://', '') info = { 'url': fixed_url, 'domain': without_scheme.split('/')[0], # without pathname 'base_url': without_scheme.split('?')[0], # without query args 'time': datetime.fromtimestamp(int(match.group(2))).strftime('%Y-%m-%d %H:%M'), 'timestamp': match.group(2), 'tags': match.group(3), 'title': match.group(4).replace(' — Readability', '').replace('http://www.readability.com/read?url=', '') or without_scheme, } info['type'] = get_link_type(info) yield info def parse_json_export(json_file): """pinboard exports are json""" json_file.seek(0) json_content = json.load(json_file) for line in json_content: if line: erg = line info = { 'url': erg['href'], 'domain': erg['href'].replace('http://', '').replace('https://', '').split('/')[0], 'base_url': erg['href'].replace('https://', '').replace('http://', '').split('?')[0], 'time': datetime.fromtimestamp(time.mktime(time.strptime(erg['time'].split(',')[0], '%Y-%m-%dT%H:%M:%SZ'))), 'timestamp': time.mktime(time.strptime(erg['time'].split(',')[0], '%Y-%m-%dT%H:%M:%SZ')), 'tags': erg['tags'], 'title': erg['description'].replace(' — Readability', ''), } info['type'] = get_link_type(info) yield info def parse_bookmarks_export(html_file): html_file.seek(0) pattern = re.compile("]*>(.+)", re.UNICODE | re.IGNORECASE) for line in html_file: match = pattern.search(line) if match: url = match.group(1) secs = match.group(2) dt = datetime.fromtimestamp(int(secs)) info = { 'url': url, 'domain': url.replace('http://', '').replace('https://', '').split('/')[0], 'base_url': url.replace('https://', '').replace('http://', '').split('?')[0], 'time': dt, 'timestamp': secs, 'tags': "", 'title': match.group(3), } info['type'] = get_link_type(info) yield info ### ACHIVING FUNCTIONS def fetch_wget(out_dir, link, overwrite=False): # download full site domain = link['base_url'].split('/', 1)[0] if not os.path.exists('{}/{}'.format(out_dir, domain)) or overwrite: print(' - Downloading Full Site') CMD = [ *'wget --no-clobber --page-requisites --adjust-extension --convert-links --no-parent'.split(' '), link['url'], ] try: run(CMD, stdout=DEVNULL, stderr=DEVNULL, cwd=out_dir, timeout=20) # dom.html except Exception as e: print(' Exception: {} {}'.format(e.__class__.__name__, e)) else: print(' √ Skipping site download') def fetch_pdf(out_dir, link, overwrite=False): # download PDF if (not os.path.exists('{}/output.pdf'.format(out_dir)) or overwrite) and link['type'] not in ('PDF', 'image'): print(' - Printing PDF') chrome_args = '--headless --disable-gpu --print-to-pdf'.split(' ') try: run([CHROME_BINARY, *chrome_args, link['url']], stdout=DEVNULL, stderr=DEVNULL, cwd=out_dir, timeout=20) # output.pdf if run(['chmod', ARCHIVE_PERMISSIONS, 'output.pdf'], stdout=DEVNULL, stderr=DEVNULL, timeout=5).returncode: raise Exception('Failed to print PDF') except Exception as e: print(' Exception: {} {}'.format(e.__class__.__name__, e)) else: print(' √ Skipping PDF print') def fetch_screenshot(out_dir, link, overwrite=False): # take screenshot if (not os.path.exists('{}/screenshot.png'.format(out_dir)) or overwrite) and link['type'] not in ('PDF', 'image'): print(' - Snapping Screenshot') chrome_args = '--headless --disable-gpu --screenshot'.split(' ') try: run([CHROME_BINARY, *chrome_args, '--window-size={}'.format(RESOLUTION), link['url']], stdout=DEVNULL, stderr=DEVNULL, cwd=out_dir, timeout=20) # sreenshot.png if run(['chmod', ARCHIVE_PERMISSIONS, 'screenshot.png'], stdout=DEVNULL, stderr=DEVNULL, timeout=5).returncode: raise Exception('Failed to take screenshot') except Exception as e: print(' Exception: {} {}'.format(e.__class__.__name__, e)) else: print(' √ Skipping screenshot') def archive_dot_org(out_dir, link, overwrite=False): # submit to archive.org if (not os.path.exists('{}/archive.org.txt'.format(out_dir)) or overwrite): print(' - Submitting to archive.org') submit_url = 'https://web.archive.org/save/{}'.format(link['url'].split('?', 1)[0]) success = False try: result = run(['curl', '-I', submit_url], stdout=PIPE, stderr=DEVNULL, cwd=out_dir, timeout=20) # archive.org headers = result.stdout.splitlines() content_location = [h for h in headers if b'Content-Location: ' in h] if content_location: archive_path = content_location[0].split(b'Content-Location: ', 1)[-1].decode('utf-8') saved_url = 'https://web.archive.org{}'.format(archive_path) success = True else: raise Exception('Failed to find Content-Location URL in Archive.org response headers.') except Exception as e: print(' Exception: {} {}'.format(e.__class__.__name__, e)) if success: with open('{}/archive.org.txt'.format(out_dir), 'w') as f: f.write(saved_url) else: print(' √ Skipping archive.org') def fetch_favicon(out_dir, link, overwrite=False): # download favicon if not os.path.exists('{}/favicon.ico'.format(out_dir)) or overwrite: print(' - Fetching Favicon') CMD = 'curl https://www.google.com/s2/favicons?domain={domain}'.format(**link).split(' ') fout = open('{}/favicon.ico'.format(out_dir), 'w') try: run([*CMD], stdout=fout, stderr=DEVNULL, cwd=out_dir, timeout=20) # dom.html except Exception as e: print(' Exception: {} {}'.format(e.__class__.__name__, e)) fout.close() else: print(' √ Skipping favicon') ### ORCHESTRATION def next_uniq_timestamp(used_timestamps, timestamp): """resolve duplicate timestamps by appending a decimal""" if timestamp not in used_timestamps: return timestamp if '.' in timestamp: timestamp, nonce = timestamp.split('.') nonce = int(nonce) else: nonce = 1 new_timestamp = '{}.{}'.format(timestamp, nonce) while new_timestamp in used_timestamps: nonce += 1 new_timestamp = '{}.{}'.format(timestamp, nonce) return new_timestamp def uniquefied_links(links): """uniqueify link timestamps by de-duping using url, returns links sorted most recent -> oldest needed because firefox will produce exports where many links share the same timestamp, this func ensures that all non-duplicate links have monotonically increasing timestamps""" links = list(reversed(sorted(links, key=lambda l: (l['timestamp'], l['url'])))) seen_timestamps = {} for link in links: t = link['timestamp'] if t in seen_timestamps: if link['url'] == seen_timestamps[t]['url']: # don't create new unique timestamp if link is the same continue else: # resolve duplicate timstamp by appending a decimal link['timestamp'] = next_uniq_timestamp(seen_timestamps, link['timestamp']) seen_timestamps[link['timestamp']] = link return links def valid_links(links): return (link for link in links if link['url'].startswith('http') or link['url'].startswith('ftp')) def dump_index(links, service): with open(INDEX_TEMPLATE, 'r') as f: index_html = f.read() link_html = """\ {time} {title} {tags} 📂 📄 🖼 🏛 🔗 {url} """ def get_template_vars(link): # since we dont screenshot or PDF links that are images or PDFs, change those links to point to the wget'ed file link_info = {**link} if link['type']: link_info.update({'title': '{title} ({type})'.format(**link)}) if link['type'] in ('PDF', 'image'): link_info.update({ 'pdf_link': 'archive/{timestamp}/{base_url}'.format(**link), 'screenshot_link': 'archive/{timestamp}/{base_url}'.format(**link), }) else: link_info.update({ 'pdf_link': 'archive/{timestamp}/output.pdf'.format(**link), 'screenshot_link': 'archive/{timestamp}/screenshot.png'.format(**link) }) return link_info with open(''.join((service, '/index.html')), 'w') as f: article_rows = '\n'.join( link_html.format(**get_template_vars(link)) for link in links ) f.write(index_html.format(datetime.now().strftime('%Y-%m-%d %H:%M'), article_rows)) def dump_website(link, service, overwrite=False): """download the DOM, PDF, and a screenshot into a folder named after the link's timestamp""" print('[+] [{timestamp} ({time})] "{title}": {base_url}'.format(**link)) out_dir = ''.join((service, '/archive/{timestamp}')).format(**link) if not os.path.exists(out_dir): os.makedirs(out_dir) run(['chmod', ARCHIVE_PERMISSIONS, out_dir], timeout=5) if link['type']: print(' i Type: {}'.format(link['type'])) if not link['url'].startswith('http'): print(' X Skipping: invalid link.') return if FETCH_WGET: fetch_wget(out_dir, link, overwrite=overwrite) if FETCH_PDF: fetch_pdf(out_dir, link, overwrite=overwrite) if FETCH_SCREENSHOT: fetch_screenshot(out_dir, link, overwrite=overwrite) if SUBMIT_ARCHIVE_DOT_ORG: archive_dot_org(out_dir, link, overwrite=overwrite) if FETCH_FAVICON: fetch_favicon(out_dir, link, overwrite=overwrite) def create_archive(export_file, service=None, resume=None): with open(export_file, 'r', encoding='utf-8') as f: print('[+] [{}] Starting archive from {} export file.'.format(datetime.now().strftime('%Y-%m-%d %H:%M:%S'), export_file)) if service == "pocket": links = parse_pocket_export(f) elif service == "pinboard": links = parse_json_export(f) elif service == "bookmarks": links = parse_bookmarks_export(f) else: # try all parsers until one works try: links = list(parse_json_export(f)) service = 'pinboard' except Exception: links = list(parse_pocket_export(f)) if links: service = 'pocket' else: links = list(parse_bookmarks_export(f)) service = 'bookmarks' links = valid_links(links) # remove chrome://, about:, mailto: etc. links = uniquefied_links(links) # fix duplicate timestamps, returns sorted list if resume: try: links = [link for link in links if float(link['timestamp']) >= float(resume)] except TypeError: print('Resume value and all timestamp values must be valid numbers.') if not links: print('[X] No links found in {}, is it a {} export file?'.format(export_file, service)) raise SystemExit(1) if not os.path.exists(service): os.makedirs(service) if not os.path.exists(''.join((service, '/archive'))): os.makedirs(''.join((service, '/archive'))) dump_index(links, service) run(['chmod', '-R', ARCHIVE_PERMISSIONS, service], timeout=30) print('[*] [{}] Created archive index with {} links.'.format(datetime.now().strftime('%Y-%m-%d %H:%M:%S'), len(links))) check_dependencies() for link in links: dump_website(link, service) print('[√] [{}] Archive complete.'.format(datetime.now())) if __name__ == '__main__': argc = len(sys.argv) export_file = sys.argv[1] if argc > 1 else "ril_export.html" # path to export file export_type = sys.argv[2] if argc > 2 else None # select export_type for file format select resume_from = sys.argv[3] if argc > 3 else None # timestamp to resume dowloading from create_archive(export_file, export_type, resume=resume_from)