0.25.0

Welcome to the 0.25.0 release of Karakeep! This release addresses a lot of the top most upvoted feature requests. You can now share lists publicly, generate RSS feeds from your lists, reader view & pdf support in the mobile app, bi-directional browser bookmark sync using floccus, maintaining list structure on imports and a lot more. As usual, we have a lot of contributors in this release: @xuatz, @digithree, @thiswillbeyourgithub, @codelove77, @SConaway, @vhsdream, @AdrianAcala, @spasche, @SalGnt, @haappi, @yuikisaito, @jk, @jakeasmith, @Mxrk, @WilliamAGH, and @SteffoSpieler!

If you enjoy using Karakeep, consider supporting the project here ☕️ or via GitHub here.

New Features 🚀

• Public Lists are here: You can now share your curated lists publicly! (#1511). Example list here.
• RSS Feed Generation: Create and share RSS feeds directly for your lists (#1507)
• Overdue Mobile Improvements:
  • Added reader mode/screenshot/archive views to bookmark previews on mobile (pending app release) (#1509) - @digithree
  • View PDFs directly in the mobile app and share them to karakeep from the share sheet as well (#1519, #1494) - @codelove77
• Import / Export improvements:
  • Added NETSCAPE file export format support (#1374) - @yuikisaito
  • When importing netscape style bookmarks into karakeep, your lists will be re-created on karakeep. Preserving lists from other sources is planned.
  • Preserve archived status when importing from omnivore or pocket (RIP).
• AI Auto-Summarization: Automatic summarization for new bookmarks can be now be enabled with INFERENCE_ENABLE_AUTO_SUMMARIZATION=true (#1163)
• Floccus Integration: Karakeep now supports bi-directional sync with browser bookmarks using Floccus. This will be available in the next Floccus release within a week or two.

UX Improvements ✨

• The user setting page got fully redesigned to look nicer given that we’re starting to have more user settings.
• Tab-based layout for bookmark previews on small screens - @thiswillbeyourgithub
• Save pages faster with a dedicated extension shortcut (#1532) - @SConaway
• Configure the default behavior when clicking on a bookmark. Either go to source, or expand the details.
• Restored ability to properly sort by creation date for search pages (#1392) - @xuatz
• You can now decide what you want to do when using the singlefile extension on an existing bookmark. Check out how to customize it here.
• Configure whether you want to see archived bookmarks in lists or tags or not (#1505) - @xuatz
• Added Algolia-based search to docs
• Added “deleted” webhook event (#1464) - @SalGnt
• The Summarize with AI button no longer shows up if you don’t have AI configured
• You can now disable auto AI tagging if not needed
• Allow enabling/disabling RSS feeds collection
• Added US English to folks who can’t stand the British English - @WilliamAGH
• Improved the positioning of the highlights menu on mobile devices - @Mxrk
• Moved delete button in bookmark menu in the app for better ergonomics

Fixes 🐛

• Started using proper tokenizer for content truncation before inference. This should prevent the truncation of the model prompt leading to better accuracy and instruction adherence.
• Preserve unsaved changes during tag modifications while editing bookmarks (#1515) - @AdrianAcala
• Fixed tag drag-and-drop issues on Firefox (#1016) - @haappi
• Added log rotation for linux installations (#1471) - @vhsdream
• You can now run Karakeep container as a non-root user for better security.

For Developers 🛠️

• Added ?sortOrder parameter for resource sorting (#1398) - @xuatz
• New endpoint for tag creation
• PUT operations for bookmarks are now idempotent (e.g. adding to list) (#1427) - @xuatz
• Added PATCH method support to CORS headers (#1489) - @spasche
• Documentation:
  • Added documentation for the asset upload APIs
  • Fixed JSON examples in MCP documentation (#1400, #1419) - @jk, @jakeasmith
  • Expanded Meilisearch upgrade guides (#1436) - @thiswillbeyourgithub

Community Projects 💡

• Python-based SDK for Karakeep: karakeep-python-api - @thiswillbeyourgithub
• Freshrss Importer: freshrss-to-karakeep - @thiswillbeyourgithub

Screenshots 📸

The Share List Modal

Tabbed Layout on smaller screens

Reader Mode in the app

Upgrading 📦

To upgrade:

• If you’re using KARAKEEP_VERSION=release, run docker compose pull && docker compose up -d.
• If you’re pinning it to a specific version, upgrade the version and then run docker compose pull && docker compose up -d.

All Commits

• release(extension): Bump extension version to 1.2.6 - @MohamedBassem in 5b520667
• release(mobile): Bump mobile version to 1.7.0 - @MohamedBassem in 3c48bb8d
• ci: Fix manifest formatting - @MohamedBassem in b93f3a4a
• feat(mobile): Add support for viewing PDFs (#1519) - @codelove77 in 0fde1087
• fix(mobile): Move the delete button to the end in the bookmark menu - @MohamedBassem in 421e3e86
• feat(mobile): add reader/screenshot/archive view to bookmark preview (#1509) - @digithree in ec31a971
• fix(build): karakeep-linux.sh fix use ‘append’ instead of ‘file’ for log (#1471) - @vhsdream in 09e5dd65
• feat(extension): add a keyboard shortcut to save page (#1532) - @SConaway in ee517456
• feat(ui): Improve the look of the public bookmarks page - @MohamedBassem in 3a0f5fa0
• fix: Use a new public list metadata endpoint for metadata generation - @MohamedBassem in bc65a738
• docs: Add asset APIs to the openapi spec - @MohamedBassem in a98f0236
• fix(web): Smaller card titles in the user info page - @MohamedBassem in 4e481f4b
• fix: preserve unsaved title changes when modifying bookmark tags in the edit dialog (#1515) - @AdrianAcala in f53ad0a1
• feat(web): Redesign the user settings page - @MohamedBassem in 090c0d1c
• readme: Small readme fixes - @MohamedBassem in 39feafe7
• fix(web): Drop the experimental icon from rss feeds - @MohamedBassem in bf4cbd12
• feat: Drop corepack dep in prod and allow running as non-root. Fixes #606 - @MohamedBassem in 169e14d3
• i18n: Sync weblate translations - 22460836
• Merge remote-tracking branch ‘weblate/main’ - @MohamedBassem in 7c245aa7
• feat: Maintain list structure when importing from netscape. Fixes #538 - @MohamedBassem in 1bae66f7
• feat: Allow specifying the overwrite mode for singlefile archives. Fixes #1125 - @MohamedBassem in e59be245
• feat: Add support for public lists (#1511) - @MohamedBassem in ea1d0023
• feat: add user customisable default archive display behaviour (#1505) - @xuatz in 3afe1e21
• docs: mention the list of example scripts for the community api (#1484) - @thiswillbeyourgithub in 8784c73c
• feat(mobile): Add PDF support to share extension (#1494) - @codelove77 in 5f473401
• feat: Generate RSS feeds from lists (#1507) - @MohamedBassem in 9695bba2
• refactor: Move bookmark utils from shared-react to shared - @MohamedBassem in b218118b
• docs: Add agolia based search - @MohamedBassem in 3e860b79
• doc: mention meilisearch in the updating section (#1472) - @thiswillbeyourgithub in 7f04bd13
• feat: Allow PATCH method in CORS headers (#1489) - @spasche in 915aeb36
• fix: Fix end icon in smart list input overlapping with text. Fixes #1379 - @MohamedBassem in d903c7f9
• fix: Show list options menu on list sidebar hover - @MohamedBassem in a1f77075
• fix: Truncate the RSS feed url - @MohamedBassem in e0ed727c
• chore: Add localhost labs to README and landing - @MohamedBassem in e13809fb
• fix(landing): Fix the favicon location for the landing page - @MohamedBassem in 96bce30c
• feat: Add “deleted” webhook event (#1464) - @SalGnt in 8a927e96
• docs: Update the privacy policy - @MohamedBassem in 37c18b89
• feat: Allow defaulting to reader mode when clicking on bookmarks. Fixes #662 - @MohamedBassem in 09652176
• docs: Update database docs (#1451) - @haappi in 5f3fe5d1
• feat: Read the archive status from omnivore and pocket. Fixes #703 - @MohamedBassem in c6d21afa
• build: Regen openAPI spec - @MohamedBassem in 6af14e9d
• feat: Disable the AI summary button if AI is not configured. Fixes #649 - @MohamedBassem in 85929850
• feat: Add AI auto summarization. Fixes #1163 - @MohamedBassem in 2743d9e3
• feat(api): Expose the endpoint to create a new tag - @MohamedBassem in a5ae67c2
• fix(web): Switch to a tab view in small screens for bookmark previews - @thiswillbeyourgithub in 053d1a90
• build: Fix format error - @MohamedBassem in 0e734b6b
• fix(web): Fix tag drag and drop merging on firefox .Fixes #1016 (#1309) - @haappi in c2e26f9f
• refactor: Migrate from NextJs’s API routes to Hono based routes for the API (#1432) - @MohamedBassem in 3505cb7d
• doc: document how to upgrade meilisearch / migrate meilisearch db (#1436) - @thiswillbeyourgithub in 74e74fa6
• doc: new comunity project: freshrss to karakeep (#1435) - @thiswillbeyourgithub in 3a592931
• feat(api): enable ?sortOrder= for relevant resources (#1398) - @xuatz in 4e06ea7b
• fix: Use proper tokenizer when truncating for inference. Fixes #1405 - @MohamedBassem in 70d57209
• feat: position highlight menu based on device type (#1348) - @Mxrk :) in 523a251b
• fix(search): add new relevance sort order (#1392) - @xuatz in dbd0fd19
• fix(api): make PUT bookmark to a list idempotent (#1427) - @xuatz in f338f7b1
• build(Debian): update yt-dlp on karakeep’s update and add a service check function (#1329) - @vhsdream in 4ae5857a
• doc: Mention karakeep-python-api in community projects (#1424) - @thiswillbeyourgithub in 60f47122
• docs: minor update to dev setup instructions (#1421) - @thiswillbeyourgithub in 65d7096b
• fix(landing): Fix the responsiveness of the landing page - @MohamedBassem in d44cd235
• docs: Update pikapods docs after the rename - @MohamedBassem in 6f6c9872
• feat: Allow enabling/disabling RSS feeds - @MohamedBassem in 370db082
• feat: Add karakeep metadata to openai calls - @MohamedBassem in 2a8d4b88
• doc: Fixed json syntax error in mcp docs (#1419) - @jakeasmith in 2082f87e
• docs: Fix JSON in MCP documentation (#1400) - @jk in 3ececfcc
• feat: Add NETSCAPE-Bookmark-file-1 export format support (#1374) - @yuikisaito in c03dcfdb
• fix(mcp): Correct description for get-lists tool. Fixes #1332 (#1388) - @MohamedBassem in 8b05515b
• i18n: Add US English as option in User Settings (#1327) - @WilliamAGH in 3d802db4
• docs: Update the docs about admin password reset to include the salt - @MohamedBassem in 3b246a88
• fix(docker): Fix build only docker compose file - @MohamedBassem in f4a31563