{"id":13875905,"url":"https://github.com/zefr0x/foxmarks","last_synced_at":"2025-07-31T16:05:34.879Z","repository":{"id":65087928,"uuid":"526428303","full_name":"zefr0x/foxmarks","owner":"zefr0x","description":"A CLI read-only interface for Firefox's bookmarks and history.","archived":false,"fork":false,"pushed_at":"2025-05-24T09:30:27.000Z","size":108,"stargazers_count":38,"open_issues_count":2,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-24T10:31:46.458Z","etag":null,"topics":["bookmarks","bookmarks-menu","browsing-history","cli","firefox","firefox-browser","history","linux","unix-philosophy"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zefr0x.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-08-19T01:44:10.000Z","updated_at":"2025-05-24T09:30:30.000Z","dependencies_parsed_at":"2023-12-15T19:44:35.540Z","dependency_job_id":"e49c55ce-de77-487a-8f73-72bd214ca9eb","html_url":"https://github.com/zefr0x/foxmarks","commit_stats":null,"previous_names":["zefr0x/foxmarks"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/zefr0x/foxmarks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefr0x%2Ffoxmarks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefr0x%2Ffoxmarks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefr0x%2Ffoxmarks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefr0x%2Ffoxmarks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zefr0x","download_url":"https://codeload.github.com/zefr0x/foxmarks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefr0x%2Ffoxmarks/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268067279,"owners_count":24190314,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-31T02:00:08.723Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bookmarks","bookmarks-menu","browsing-history","cli","firefox","firefox-browser","history","linux","unix-philosophy"],"created_at":"2024-08-06T06:00:49.327Z","updated_at":"2025-07-31T16:05:34.824Z","avatar_url":"https://github.com/zefr0x.png","language":"Rust","funding_links":[],"categories":["Rust","cli"],"sub_categories":[],"readme":"# foxmarks\n\n[![release](https://github.com/zefr0x/foxmarks/actions/workflows/release.yml/badge.svg)](https://github.com/zefr0x/foxmarks/actions/workflows/release.yml)\n\n\u003cbr\u003e\n\n[![AUR version](https://img.shields.io/aur/version/foxmarks?label=AUR)](https://aur.archlinux.org/packages/foxmarks)\n[![AUR votes](https://img.shields.io/aur/votes/foxmarks?label=AUR%20votes)](https://aur.archlinux.org/packages/foxmarks)\n\nA blazingly fast, highly extendable and easily integrated command line **read-only** interface for [firefox](https://www.mozilla.org/firefox)'s bookmarks and history.\n\n## Features\n- 🧾 Free software under the [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.html) licence.\n- 🔗 Built with the [Unix philosophy](https://en.wikipedia.org/wiki/Unix_philosophy) in mind.\n- 💪 Written in the [Rust](https://www.rust-lang.org/) programming language.\n- 🚫 windows is not supported.\n\n## Installation\n\n### Download Binary From Github\nFor every new release a Github workflow will build a binary in Github servers and will upload it as a release asset in Github releases.\n\nYou can find the latest Github release [here](https://github.com/zefr0x/foxmarks/releases/latest) or the releases page [here](https://github.com/zefr0x/foxmarks/releases).\n\n### [AUR](https://aur.archlinux.org/packages/foxmarks)\n\n[![AUR last modified](https://img.shields.io/aur/last-modified/foxmarks)](https://aur.archlinux.org/cgit/aur.git/log/?h=foxmarks)\n\n#### Using yay\n```shell\nyay -Sa foxmarks\n```\n\n#### Using paru\n```shell\nparu -Sa foxmarks\n```\n\n## Build\n\u003e [!Note]\n\u003e You need to have [`cargo`](https://doc.rust-lang.org/cargo/) installed in you system.\n\n```shell\ngit clone https://github.com/zefr0x/foxmarks.git\n\ncd foxmarks\n\n# Checkout to a release tag e.g. v1.0.1\ngit checkout vx.x.x\n\ncargo build --release\n```\nYou will find the binary in `./target/release/foxmarks`\n\n\n## Usage\nIt's simple, for a list of your bookmarks run:\n```shell\nfoxmarks bookmarks\n```\nFor the browsing history:\n```shell\nfoxmarks history\n```\nBy default it will try to fetch the data from the default profile of `firefox-release`, but if you have `firefox-esr` or `firefox-dev` installed, you can specify a type:\n```shell\nfoxmarks -t Esr bookmarks\n```\n\n\u003e Release: firefox-release\n\u003e\n\u003e Esr: firefox-esr\n\u003e\n\u003e Dev: firefox-dev\n\n\u003e If you are using a custom profile as your default one or you are using the flatpak version of firefox, then you need to use `profile-path` option to specify the profile you want to read from.\n\nFor more options and details read the long help:\n```shell\nfoxmarks --help\n```\n\n### Usage Examples\nSince it's a simple tool that do one thing will, you should consider compining it with another tools.\n\nPipe the output to the [`column`](https://linuxhint.com/use-linux-column-command/) command to display the results in columns, so you can read them easily.\n```shell\nfoxmarks bookmarks | column -t -s \";\"\n```\nYou can pipe them again to the [`less`](https://en.wikipedia.org/wiki/Less_(Unix)) command:\n```shell\nfoxmarks bookmarks | column -t -s \";\" | less\n```\n\nYou can integrate the tool with your favorate launcher, for example here is a script for the [rofi launcher](https://github.com/davatorium/rofi):\n```bash\n#!/usr/bin/bash\n\nif [[ $ROFI_RETV = 0 ]];\nthen\n    foxmarks bookmarks | {\n        while read -r line;\n        do\n            IFS=\";\"\n            read -r title url \u003c\u003c\u003c $line\n            printf \"%s\\0icon\\x1fbookmarks\\x1fmeta\\x1f%s\\x1finfo\\x1f%s\\x1f\\n\" $title $url $url\n        done\n    }\n\nelif [[ $ROFI_RETV = 1 ]];\nthen\n    xdg-open $ROFI_INFO\nfi\n```\n\n\u003e [!Warning]\n\u003e You might use another language like Python for better and faster implementaion.\n\n## Config\nThe default options might not fit your needs, so you can change them via a config file.\n\nThe config file is `$XDG_CONFIG_HOME/foxmarks/config` or by default `~/.config/foxmarks/config`.\nJust create it and specify the options you need with the ini format:\n```ini\n[database]\nfirefox_type = Release\nfirefox_home_path = ~/.mozilla/firefox/\nprofile_path = xxxxxxxx.default-release\n\n[output]\ncolumn_delimiter = |\nrow_delimiter = ;\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzefr0x%2Ffoxmarks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzefr0x%2Ffoxmarks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzefr0x%2Ffoxmarks/lists"}