axelrafn/tabRemember
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
tabRemember/README.md

5.3 KiB
Raw Permalink Blame History

tabRemember

A open-source app written in Python using PyQt6 for managing links for Sims players who use custom content, and for others who need a nice, simple and little bookmark manager outside the browser.

Wait, what?

My wife is one of those people and I've seen how her browsers are, she has maxed out the tabs in the Safari browser in her iPhone and is always stressed that she might lose them at any given moment. Her computer is no better..

So this project is to create a cross platform app written in Python, relying on PyQt6 for theming and looks. I plan to have it multilingual as well since not everyone uses the same language.

For the time being the languages at the start and while I build this app up towards the first release, I will only offer English and Icelandic. Later on people are welcome to offer their translations for their language as well and I will happilly add them to the codebase.

The program offers filters for domains, so you can break up the URL you have in your bookmarks and search for it. This idea came to be since a lot of custom content creators, especially on tumblr, tend to delete the original post and create a new one when they update the custom content they made. Normally that would leave you with a broken link, but with these filters you can search (with your preferred search engine mind you!) for key words from the URL, such as the domain name itself, the user who psoted it orignally, the title of the post. With these filters you can easilly find what you bookmarked even when you have a broken link.

tabRemember - URL Manager

tabRemember is a simple and effective URL manager that helps you store, search, and manage your favorite URLs with descriptions and custom search functionality.

Features

  • Save URLs with descriptions.
  • View, edit, and delete saved URLs.
  • Search saved URLs using different search engines.
  • Auto-search URLs using filters to extract meaningful search terms.

Getting Started

Installation

  1. Install Python: Ensure you have Python installed on your system. You can download it from python.org.

  2. Install Required Libraries:

    pip install PyQt6

  3. Download and Run the App:

    • Download the app files from the repository, either by downloading a zip file from here or by running the following command with git: 
      git clone https://git.axelrafn.is/axelrafn/tabRemember.git
    • Then go into the directory you just downloaded and run the application using: 
      python app.py

Main Interface

When you start the app, you'll see the main window with the following components:

  1. URL Input: A text box to enter the URL you want to save.
  2. Description Input: A text area to add a description or notes about the URL.
  3. Save URL Button: Click this button to save the URL and description.
  4. Search Input: A text box to search through your saved URLs.
  5. URL List: A table that displays your saved URLs with columns for the URL, date, and actions.

Actions Column

Each URL in the list has an "Actions" column with the following buttons:

  1. Visit Button (🔗): Opens the URL in your default web browser.
  2. Info Button (ℹ️): Opens a dialog to view and edit the URL and its description.
  3. Search Button (🔍): Searches for the URL using predefined filters. If no filter is found, it opens the URL directly.
  4. Delete Button (🗑️): Deletes the URL from your list.

Settings

Click the settings icon (⚙️) to open the settings dialog where you can:

  • Change Data Directory: Set the directory where your URLs are saved.
  • Select Search Engine: Choose your preferred search engine.
  • Set Date Format: Choose the format for displaying dates.
  • Change Language: Change the app's language. (Note: You need to restart the app for language changes to take effect.)

About

Click the info icon (ℹ️) to open the about dialog, which provides information about the developer and a link to the project's repository.

Filters

The app supports custom filters for extracting search terms from URLs. Filters are stored in the filters directory and named as domain.tld.filter.py.

Creating a Filter

  1. Create a Filter File:

    • Name the file in the format domain.tld.filter.py.
    • Example: For tumblr.com, the file name should be tumblr.com.filter.py.

  2. Define the Filter:

    • Use Python code to define how to extract search terms.
    • Example for tumblr.com: 
      from urllib.parse import urlparse, unquote

url_parts = urlparse(url)
path_segments = unquote(url_parts.path).strip('/').split('/')
terms = [url_parts.netloc.split('.')[0]] + path_segments

Example Usage

Saving a URL

  1. Enter the URL in the URL input box.
  2. Add a description in the description text area.
  3. Click the "Save URL" button.

Searching for a URL

  1. Enter search terms in the search input box.
  2. The URL list will filter results as you type.

Viewing and Editing a URL

  1. Click the info button (ℹ️) next to the URL.
  2. A dialog will open showing the URL and description.
  3. Edit the URL or description and click "Update" to save changes.

Deleting a URL

  1. Click the delete button (🗑️) next to the URL.
  2. Confirm the deletion in the dialog that appears.