Skip to content

aurelitec/Portmarks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Portmarks

Version badge MIT License badge GitHub Code Size badge Contributions Welcome badge GitHub Downloads (all assets, all releases)

Portmarks lets you create portable HTML bookmark files for any web page. Your bookmarks work everywhere—no browser sync, no cloud dependency, just tiny files you own. Free and open source.

  • Own Your Data: Bookmarks are saved as local HTML files. You have complete control, with no cloud dependency, tracking, or accounts.
  • Universal & Portable: Works in any browser on any OS. Organize your bookmarks in folders, sync them via cloud storage, or share them anywhere.
  • Simple & Private: Installs as a lightweight bookmarklet that runs entirely in your browser. The process is completely offline and private by design.

The Portable Bookmark File

Portmarks generates a minimal HTML file with a .portmark.html extension. This dual extension ensures it's recognized as a standard HTML file by your system while also indicating its origin from Portmarks.

The core design principle is to be as tiny and universal as possible. The entire file is a single line of HTML, containing only the essential meta refresh tag needed to redirect your browser.

Here is an example for https://example.com:

<html><head><meta http-equiv="refresh" content="0;url=https://example.com/" /></head><body></body></html>

Quick Start

  1. Download the Portmarks bookmarklet from GitHub Releases and unzip it.
  2. Open the install.html file in your browser.
  3. Drag the Portmarks button to your bookmarks bar.
  4. Click the bookmarklet on any page to download a portable bookmark file.

Project Structure

  • bookmarklet/ — Source code and install files for the Portmarks bookmarklet.
  • bookmarklet/dist/ — Distribution files and release ZIPs (after building).

Building from Source

If you want to modify the bookmarklet or build it yourself, follow these steps:

  1. Clone the repository:
    git clone https://github.com/aurelitec/Portmarks.git
  2. Navigate to the bookmarklet directory:
    cd Portmarks/bookmarklet
  3. Install the development dependencies:
    npm install
  4. Run the build script:
    npm run build

The distributable files will be generated in the bookmarklet/dist/files directory.

Contributing

Contributions are welcome! If you have a suggestion or find a bug, please open an issue.

If you'd like to contribute code, please fork the repository and submit a pull request.

License

Portmarks is a free, open-source project by Aurelitec, released under the MIT License.

Support Us!

We can offer our apps for free because we are supported by our partners at East-Tec, developers of award-winning privacy and security software since 1997. You can support us by trying their products.

While Portmarks helps you save the sites you want to remember, east-tec Eraser helps you forget the ones you don't want anyone to know about.


East-Tec product boxes