# bookmarks **Repository Path**: mirrors_jaywcjlove/bookmarks ## Basic Information - **Project Name**: bookmarks - **Description**: This project provides bookmark data for Menuist v4.1+. Simply add the bookmarks folder from this project to Menuist's common directories to quickly generate a website navigation menu for convenient access to frequently used websites. - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-10-14 - **Last Updated**: 2026-09-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

^{Using my app is also a way to support me:}

Menuist Bookmarks === [![Buy me a coffee](https://img.shields.io/badge/Buy_Me_a_Coffee-ffdd00?logo=buy-me-a-coffee&logoColor=black)](https://jaywcjlove.github.io/#/sponsor) [![Follow On X](https://img.shields.io/badge/Follow%20on%20X-333333?logo=x&logoColor=white)](https://x.com/jaywcjlove) ![Bookmark](./assets/bookmark.png) This project provides organized bookmark data and a small `bkm` command for turning the [`bookmarks`](./bookmarks/) directory into a static navigation website. It can also be used with [Menuist](https://github.com/jaywcjlove/rightmenu-master) v4.1+ by adding the `bookmarks` folder to Menuist's common directories for quick access to frequently used websites. ![Menuist Screenshots](./assets/menuist-screenshots.png) The bookmarks in this project are stored using macOS and iOS system's `.webloc` file format, where each `.webloc` file is a shortcut pointing to a specific URL. Websites can be organized with folders, used directly in Menuist, or generated as a static HTML navigation page with icons and optional GitHub Pages publishing. ![Menuist Bookmarks](./assets/menuist-bookmarks.png) ## Directory Structure ```shell ├── bookmarks/ # Store .webloc files (supports subfolders) │ ├── menuist.ini # ⚠️ Menuist configuration │ ├── GitHub.webloc │ ├── Gmail.webloc │ ├── AI/ # Supports subfolders │ │ ├── ChatGPT.webloc │ │ ├── Claude.webloc │ │ └── ... │ └── ... ├── icons/ # Store icon files │ ├── github.com.icns │ ├── google.com.icns │ ├── chatgpt.com.icns │ └── ... ├── bkm.swift # Swift source code └── bkm # Compiled binary file ``` ## Add a new bookmark 1️⃣ In the [`bookmarks/`](./bookmarks/) directory, create a text file named [`Apple.webloc`](./bookmarks/Apple.webloc) (with the `.webloc` extension). Paste the following `XML` content into it, and edit the URL as needed. ```xml URL https://www.apple.com/ ``` ![add bookmark](./assets/add-bookmark.gif) 2️⃣ Add a Bookmark Icon Place the downloaded `.icns` icon file into the `icons` directory and name it after the website, for example [`apple.com.icns`](./icons/apple.com.icns). Then run the [`./bkm`](./bkm) command to automatically apply the icon to the [`Apple.webloc`](./bookmarks/Apple.webloc) file. You can obtain or create `.icns` icon files in the following ways: - Download ready-made icons from [macOSicons](https://macosicons.com) - Create custom app icons using [Iconed](https://apps.apple.com/app/iconed/id6739444407) - Create folder icons and export them as `.icns` using [Iconize Folder](https://apps.apple.com/app/iconize-folder/id6478772538) ## Setting Icons for webloc Files The script can automatically set icons for `.webloc` files by matching corresponding icon files from the `icons` directory based on the domain name of the URL. 1️⃣ Method 1: Run Swift script directly (requires Swift installation) ```bash swift bkm.swift ``` 2️⃣ Method 2: Compile to binary file (recommended) If you don't have a Swift environment to run the Swift script, you can directly run the [`./bkm`](./bkm) command file to set file icons. ```bash # Manual compilation to generate a binary file swiftc -o bkm bkm.swift # Make the command executable chmod +x bkm # Run ./bkm ``` Available command options: ```bash # Set icons for .webloc files. This is the default behavior. ./bkm --set-icons # Generate a static bookmark navigation page at .html/index.html. # Web icons are exported to .html/icons/. ./bkm --generate-html # Generate the static page and include the current GitHub repository link. ./bkm --generate-html --include-github-link # Commit existing .html contents to the gh-pages branch root. # The command also writes .nojekyll on gh-pages for GitHub Pages. ./bkm --publish-gh-pages ``` If you see `zsh: bad CPU type in executable: ./bkm` on an Intel Mac, the existing binary was built for a different CPU architecture. Rebuild an Intel binary: ```bash swiftc -target x86_64-apple-macosx13.0 -o bkm bkm.swift chmod +x bkm ``` To generate a universal binary that supports both Apple Silicon and Intel Macs, compile the two architecture-specific binaries first, then merge them with `lipo`: ```bash swiftc -target arm64-apple-macosx13.0 -o bkm_arm64 bkm.swift && \ swiftc -target x86_64-apple-macosx13.0 -o bkm_x86_64 bkm.swift && \ lipo -create -output bkm bkm_arm64 bkm_x86_64 && \ chmod +x bkm ``` The `lipo` command cannot compile source code by itself. If `bkm_arm64` or `bkm_x86_64` does not exist yet, run the full command block above instead of running only the `lipo` line. ## Configuration Place a [`menuist.ini`](./bookmarks/menuist.ini) configuration file in the root of your bookmarks directory to hide certain menu items and keep the bookmarks menu tidy. Alternatively, you can use a hidden file `.menuist.ini` as the configuration. ```ini [options] ; Show file extensions showFileExtension = false ; Show frequently used apps menu showCommonAppMenu = false ; Show "Open in Finder" menu showOpenInFinderMenu = false ; Show parent folder menu showParentFolderMenu = false ``` ## License MIT © [Kenny Wong](https://wangchujiang.com)