Option to see all links of all lists in one view

[stephansann]

Hello

First of all - love this app ❤️

Anyhow one thing would make it sooo much more useful - an option to see all links of all lists in one view. Like so:

This would save us sooo many clicks!

So please, please, please - with sugar on it - can we have it?

Thanks a lot and best regards
Stephan

[stephansann]

For the time being, I created a Python script which will use the LinkAce API to fetch the existing lists.
It will then create an HTML file similar to the example above.
Not as perfect yet, but better than nothing.

#!/usr/bin/env python3
"""
LinkAce Lists Viewer
Fetches all lists and links from LinkAce API v2 and generates a single HTML page
with a three-column layout similar to Bookmark Ninja's overview page.
"""

import requests
import json
from datetime import datetime
import sys
import os
from urllib.parse import urlparse

# Configuration
LINKACE_BASE_URL = "https://your-linkace-instance.com"  # Replace with your LinkAce URL
API_TOKEN = "your-api-token-here"  # Replace with your API token
OUTPUT_FILE = "linkace_overview.html"

class LinkAceViewer:
    def __init__(self, base_url, api_token):
        self.base_url = base_url.rstrip('/')
        self.api_token = api_token
        self.headers = {
            'Authorization': f'Bearer {api_token}',
            'Accept': 'application/json',
            'Content-Type': 'application/json'
        }
    
    def fetch_lists(self):
        """Fetch all lists from LinkAce API v2"""
        lists = []
        page = 1
        
        while True:
            url = f"{self.base_url}/api/v2/lists"
            params = {
                'page': page,
                'per_page': 100  # Max items per page
            }
            
            try:
                response = requests.get(url, headers=self.headers, params=params)
                response.raise_for_status()
                data = response.json()
                
                if 'data' in data:
                    lists.extend(data['data'])
                    
                    # Check if there are more pages
                    if 'next_page_url' in data and data['next_page_url']:
                        page += 1
                    else:
                        break
                else:
                    break
                    
            except requests.exceptions.RequestException as e:
                print(f"Error fetching lists: {e}")
                break
        
        return lists
    
    def fetch_links_for_list(self, list_id):
        """Fetch all links for a specific list using API v2"""
        links = []
        page = 1
        
        while True:
            url = f"{self.base_url}/api/v2/lists/{list_id}/links"
            params = {
                'page': page,
                'per_page': 100
            }
            
            try:
                response = requests.get(url, headers=self.headers, params=params)
                response.raise_for_status()
                data = response.json()
                
                if 'data' in data:
                    links.extend(data['data'])
                    
                    if 'next_page_url' in data and data['next_page_url']:
                        page += 1
                    else:
                        break
                else:
                    break
                    
            except requests.exceptions.RequestException as e:
                print(f"Error fetching links for list {list_id}: {e}")
                break
        
        return links
    
    def fetch_all_links(self):
        """Fetch all links without list filtering using API v2"""
        links = []
        page = 1
        
        while True:
            url = f"{self.base_url}/api/v2/links"
            params = {
                'page': page,
                'per_page': 100
            }
            
            try:
                response = requests.get(url, headers=self.headers, params=params)
                response.raise_for_status()
                data = response.json()
                
                if 'data' in data:
                    links.extend(data['data'])
                    
                    if 'next_page_url' in data and data['next_page_url']:
                        page += 1
                    else:
                        break
                else:
                    break
                    
            except requests.exceptions.RequestException as e:
                print(f"Error fetching links: {e}")
                break
        
        return links
    
    def get_domain(self, url):
        """Extract domain from URL for display"""
        try:
            parsed = urlparse(url)
            return parsed.netloc or parsed.path
        except:
            return ""
    
    def generate_html(self, lists_data):
        """Generate HTML page with all lists and links"""
        html = """<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>LinkAce Overview - All Lists</title>
    <style>
        * {
            margin: 0;
            padding: 0;
            box-sizing: border-box;
        }
        
        body {
            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
            min-height: 100vh;
            padding: 20px;
        }
        
        .header {
            text-align: center;
            color: white;
            margin-bottom: 30px;
            padding: 20px;
        }
        
        .header h1 {
            font-size: 2.5em;
            font-weight: 300;
            text-shadow: 2px 2px 4px rgba(0,0,0,0.2);
        }
        
        .header .subtitle {
            margin-top: 10px;
            opacity: 0.9;
            font-size: 1.1em;
        }
        
        .container {
            max-width: 1400px;
            margin: 0 auto;
        }
        
        .columns {
            display: grid;
            grid-template-columns: repeat(3, 1fr);
            gap: 20px;
        }
        
        @media (max-width: 1024px) {
            .columns {
                grid-template-columns: repeat(2, 1fr);
            }
        }
        
        @media (max-width: 640px) {
            .columns {
                grid-template-columns: 1fr;
            }
        }
        
        .list-card {
            background: white;
            border-radius: 12px;
            box-shadow: 0 10px 30px rgba(0,0,0,0.2);
            overflow: hidden;
            transition: transform 0.3s ease, box-shadow 0.3s ease;
            margin-bottom: 20px;
        }
        
        .list-card:hover {
            transform: translateY(-3px);
            box-shadow: 0 15px 40px rgba(0,0,0,0.25);
        }
        
        .list-header {
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
            color: white;
            padding: 15px 20px;
            cursor: pointer;
            display: flex;
            justify-content: space-between;
            align-items: center;
            user-select: none;
            transition: background 0.3s ease;
        }
        
        .list-header:hover {
            background: linear-gradient(135deg, #5568d3 0%, #6b4291 100%);
        }
        
        .list-header h2 {
            font-size: 1.3em;
            font-weight: 500;
        }
        
        .list-info {
            display: flex;
            align-items: center;
            gap: 15px;
        }
        
        .link-count {
            background: rgba(255,255,255,0.2);
            padding: 4px 10px;
            border-radius: 20px;
            font-size: 0.9em;
        }
        
        .toggle-icon {
            font-size: 1.2em;
            transition: transform 0.3s ease;
        }
        
        .list-header.collapsed .toggle-icon {
            transform: rotate(-90deg);
        }
        
        .list-content {
            max-height: 600px;
            overflow-y: auto;
            transition: max-height 0.3s ease, padding 0.3s ease;
            padding: 10px;
        }
        
        .list-content.collapsed {
            max-height: 0;
            padding: 0 10px;
            overflow: hidden;
        }
        
        .link-item {
            display: block;
            padding: 12px 15px;
            margin: 5px 0;
            background: #f8f9fa;
            border-radius: 8px;
            text-decoration: none;
            color: #333;
            transition: all 0.2s ease;
            border-left: 3px solid transparent;
        }
        
        .link-item:hover {
            background: #e9ecef;
            border-left-color: #667eea;
            transform: translateX(3px);
        }
        
        .link-title {
            font-weight: 500;
            font-size: 0.95em;
            margin-bottom: 4px;
            color: #2c3e50;
            display: block;
        }
        
        .link-domain {
            font-size: 0.8em;
            color: #7f8c8d;
            display: flex;
            align-items: center;
            gap: 5px;
        }
        
        .link-domain::before {
            content: "🔗";
            font-size: 0.9em;
        }
        
        .empty-list {
            padding: 30px;
            text-align: center;
            color: #adb5bd;
            font-style: italic;
        }
        
        .stats {
            background: white;
            border-radius: 12px;
            padding: 20px;
            margin-bottom: 30px;
            box-shadow: 0 5px 20px rgba(0,0,0,0.1);
            display: flex;
            justify-content: space-around;
            flex-wrap: wrap;
            gap: 20px;
        }
        
        .stat-item {
            text-align: center;
        }
        
        .stat-value {
            font-size: 2em;
            font-weight: bold;
            color: #667eea;
        }
        
        .stat-label {
            color: #6c757d;
            font-size: 0.9em;
            margin-top: 5px;
        }
        
        /* Custom scrollbar */
        .list-content::-webkit-scrollbar {
            width: 6px;
        }
        
        .list-content::-webkit-scrollbar-track {
            background: #f1f1f1;
            border-radius: 3px;
        }
        
        .list-content::-webkit-scrollbar-thumb {
            background: #667eea;
            border-radius: 3px;
        }
        
        .list-content::-webkit-scrollbar-thumb:hover {
            background: #5568d3;
        }
    </style>
</head>
<body>
    <div class="header">
        <h1>📚 LinkAce Overview</h1>
        <div class="subtitle">All your bookmarks in one place</div>
    </div>
    
    <div class="container">
        <div class="stats">
            <div class="stat-item">
                <div class="stat-value">""" + str(len(lists_data)) + """</div>
                <div class="stat-label">Lists</div>
            </div>
            <div class="stat-item">
                <div class="stat-value">""" + str(sum(len(lst['links']) for lst in lists_data)) + """</div>
                <div class="stat-label">Total Links</div>
            </div>
            <div class="stat-item">
                <div class="stat-value">""" + datetime.now().strftime("%B %d, %Y") + """</div>
                <div class="stat-label">Generated</div>
            </div>
        </div>
        
        <div class="columns">
"""
        
        # Distribute lists across columns
        for idx, list_data in enumerate(lists_data):
            list_name = list_data.get('name', 'Unnamed List')
            list_id = list_data.get('id', idx)
            links = list_data.get('links', [])
            
            html += f"""
            <div class="list-card">
                <div class="list-header" onclick="toggleList('list-{list_id}', this)">
                    <h2>{list_name}</h2>
                    <div class="list-info">
                        <span class="link-count">{len(links)} links</span>
                        <span class="toggle-icon">▼</span>
                    </div>
                </div>
                <div class="list-content" id="list-{list_id}">
"""
            
            if links:
                for link in links:
                    title = link.get('title', link.get('url', 'Untitled'))
                    url = link.get('url', '#')
                    domain = self.get_domain(url)
                    
                    html += f"""
                    <a href="{url}" target="_blank" class="link-item">
                        <span class="link-title">{title}</span>
                        <span class="link-domain">{domain}</span>
                    </a>
"""
            else:
                html += """
                    <div class="empty-list">No links in this list</div>
"""
            
            html += """
                </div>
            </div>
"""
        
        html += """
        </div>
    </div>
    
    <script>
        function toggleList(listId, header) {
            const content = document.getElementById(listId);
            content.classList.toggle('collapsed');
            header.classList.toggle('collapsed');
        }
        
        // Collapse all lists on load (optional - remove if you want them expanded by default)
        // document.addEventListener('DOMContentLoaded', function() {
        //     document.querySelectorAll('.list-content').forEach(content => {
        //         content.classList.add('collapsed');
        //     });
        //     document.querySelectorAll('.list-header').forEach(header => {
        //         header.classList.add('collapsed');
        //     });
        // });
    </script>
</body>
</html>"""
        
        return html
    
    def run(self):
        """Main execution method"""
        print("🔄 Fetching lists from LinkAce API v2...")
        lists = self.fetch_lists()
        
        if not lists:
            print("⚠️  No lists found or unable to connect to API")
            print("   Please check your LINKACE_BASE_URL and API_TOKEN")
            print("   Make sure your LinkAce instance supports API v2")
            return False
        
        print(f"✅ Found {len(lists)} lists")
        
        # Prepare data structure
        lists_data = []
        
        # Fetch links for each list
        for lst in lists:
            list_id = lst.get('id')
            list_name = lst.get('name', 'Unnamed List')
            
            print(f"🔄 Fetching links for list: {list_name}")
            links = self.fetch_links_for_list(list_id)
            
            lists_data.append({
                'id': list_id,
                'name': list_name,
                'description': lst.get('description', ''),
                'links': links
            })
            
            print(f"   Found {len(links)} links")
        
        # Also fetch unassigned links
        print("🔄 Fetching unassigned links...")
        all_links = self.fetch_all_links()
        
        # Filter for links without lists
        unassigned_links = [link for link in all_links if not link.get('lists') or len(link.get('lists', [])) == 0]
        
        if unassigned_links:
            print(f"   Found {len(unassigned_links)} unassigned links")
            lists_data.append({
                'id': 'unassigned',
                'name': '📌 Unassigned Links',
                'description': 'Links not assigned to any list',
                'links': unassigned_links
            })
        
        # Generate HTML
        print("🔨 Generating HTML...")
        html_content = self.generate_html(lists_data)
        
        # Write to file
        with open(OUTPUT_FILE, 'w', encoding='utf-8') as f:
            f.write(html_content)
        
        print(f"✅ HTML page generated successfully: {OUTPUT_FILE}")
        print(f"   Total lists: {len(lists_data)}")
        print(f"   Total links: {sum(len(lst['links']) for lst in lists_data)}")
        
        return True

def main():
    """Main entry point"""
    print("=" * 50)
    print("LinkAce Lists Viewer (API v2)")
    print("=" * 50)
    
    # Check if configuration is set
    if LINKACE_BASE_URL == "https://your-linkace-instance.com" or API_TOKEN == "your-api-token-here":
        print("\n⚠️  ERROR: Please configure your LinkAce settings!")
        print("\n1. Edit this script and set:")
        print("   - LINKACE_BASE_URL: Your LinkAce instance URL")
        print("   - API_TOKEN: Your LinkAce API token")
        print("\nTo get your API token:")
        print("1. Log into LinkAce")
        print("2. Go to Settings → API Tokens")
        print("3. Create a new token or use an existing one")
        print("\nNote: This script uses LinkAce API v2")
        sys.exit(1)
    
    # Create viewer instance and run
    viewer = LinkAceViewer(LINKACE_BASE_URL, API_TOKEN)
    
    if viewer.run():
        print(f"\n🎉 Success! Open '{OUTPUT_FILE}' in your browser to view your links.")
        
        # Try to open in default browser
        try:
            import webbrowser
            webbrowser.open(f"file://{os.path.abspath(OUTPUT_FILE)}")
            print("   Browser opened automatically.")
        except:
            pass
    else:
        print("\n❌ Failed to generate the overview page.")
        print("   Please verify your LinkAce instance is running and API v2 is available.")
        sys.exit(1)

if __name__ == "__main__":
    main()

[babydu]

Hi, it's perfect!
Could you please explain how to use it? And does it can update the links automatically?

[stephansann]

Hi @babydu

Thanks, but it's far from perfect. I see it as a conversation starter.

Usage:
Change the variables under "# Configuration" to your situation (the API token has to be created on the LinkAce GUI), save it as a Python file (for example "overview-generator.py", make it executable (chmod 755), and run it.

Update links:
When you have new links, just run the script again.

As I said - a lot to improve.
But in the end this should be a part of LinkAce, not something external.

[babydu]

Hi,
Thanks for your reply and the introduction.
I will try to test it.
If I found some problems or others should be improved, I will tell you.
And I agree you that you say about that it's should be a part of linkace!