2021-07-04 19:14:32 +02:00
<!DOCTYPE html>
< html lang = "en" >
2021-05-24 01:16:43 +02:00
<!--
!!! WARNING !!!
This file was auto-generated from readme/clipper.md and any manual change
made to it will be overwritten. To make a change to this file please modify
the source Markdown file:
https://github.com/laurent22/joplin/blob/dev/readme/clipper.md
-->
2021-07-04 19:14:32 +02:00
< head >
< meta
charset="utf-8"
http-equiv="X-UA-Compatible"
content="IE=edge,chrome=1"
/>
< link rel = "icon" href = "/images/favicon.png" / >
< meta name = "viewport" content = "width=device-width, initial-scale=1" / >
< meta name = "theme-color" content = "#000000" / >
< meta name = "description" content = "Joplin website" / >
< link
rel="stylesheet"
href="/ css/bootstrap5.0.2.min.css"
as="style"
/>
2021-07-16 18:14:56 +02:00
< link rel = "stylesheet" href = "/css/fontawesome-all.min.css?t=1626452079487" >
2021-07-04 19:14:32 +02:00
< link
href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;500;600;700& display=swap"
rel="stylesheet"
as="style"
media="all"
onload="this.media='all'; this.onload = null"
/>
2021-07-16 18:14:56 +02:00
< link rel = "stylesheet" href = "/css/site.css?t=1626452079487" as = "style" / >
2021-07-04 19:14:32 +02:00
< title > Joplin Web Clipper | Joplin< / title >
< / head >
2021-07-10 12:22:31 +02:00
< body class = "website-env-prod" >
< div class = "container-fluid generic-template -page" id = "main-container" >
2021-05-24 01:16:43 +02:00
2021-07-10 12:22:31 +02:00
< div class = " navbar-main white-bg" id = "nav-section" >
< div class = "container" >
< div class = "row" >
< div class = "col-3" >
< a href = "/" >
< img
src="/ images/logo-text-blue.svg"
alt=""
id="top-logo"
width="180"
/>
< / a >
< / div >
< div class = "col-9 text-right d-none d-md-block" >
< a href = "/help/" class = "fw500" > Help< / a >
< a href = "https://discourse.joplinapp.org/" class = "fw500" > Forum< / a >
2021-07-16 18:14:56 +02:00
< a class = "button-link btn-blue sponsor-button" href = "/donate" >
< i class = "fas fa-heart heart-full" > < / i > < i class = "far fa-heart heart-line" > < / i > Support us
2021-07-10 12:22:31 +02:00
< / a > < / div >
< div class = "col-9 text-right d-block d-md-none" >
< span class = "pointer"
>< img
src="/ images/mobile-menu-black-open-icon.png"
id="open-menu-mobile"
alt=""
/>< / span >
2021-05-24 01:16:43 +02:00
2021-07-10 12:22:31 +02:00
< div id = "menu-mobile" >
< div >
< div class = "text-right" >
< img
src="/ images/close-icon.png"
alt=""
class="pointer"
id="close-menu-mobile"
/>
2021-07-04 19:14:32 +02:00
< / div >
2021-05-24 01:16:43 +02:00
2021-07-10 12:22:31 +02:00
< div class = "text-center menu-mobile-top" >
< a href = "https://discourse.joplinapp.org/" class = "fw500 mobile-menu-link" > Forum< / a >
< a href = "/help/" class = "fw500 mobile-menu-link" > Help< / a >
< / div >
2021-05-24 01:16:43 +02:00
2021-07-10 12:22:31 +02:00
< div class = "menu-mobile-buttons" >
2021-07-16 18:14:56 +02:00
< a class = "button-link btn-blue sponsor-button" href = "/donate" >
< i class = "fas fa-heart heart-full" > < / i > < i class = "far fa-heart heart-line" > < / i > Support us
2021-07-10 12:22:31 +02:00
< / a > < / div >
< / div >
2021-05-24 01:16:43 +02:00
2021-07-16 18:14:56 +02:00
< div id = "toc-mobile" > < div > < ul >
2021-07-04 19:14:32 +02:00
< li >
< p > Applications< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/desktop/" > Desktop application< / a > < / li >
< li > < a href = "/mobile/" > Mobile applications< / a > < / li >
< li > < a href = "/terminal/" > Terminal application< / a > < / li >
< li > < a href = "/clipper/" > Web Clipper< / a > < / li >
2021-07-04 19:14:32 +02:00
< / ul >
< / li >
< li >
< p > Support< / p >
< ul >
< li > < a href = "https://discourse.joplinapp.org" > Joplin Forum< / a > < / li >
2021-07-10 12:22:31 +02:00
< li > < a href = "/markdown/" > Markdown Guide< / a > < / li >
< li > < a href = "/e2ee/" > How to enable end-to-end encryption< / a > < / li >
< li > < a href = "/conflict/" > What is a conflict?< / a > < / li >
< li > < a href = "/debugging/" > How to enable debug mode< / a > < / li >
< li > < a href = "/rich_text_editor/" > About the Rich Text editor limitations< / a > < / li >
< li > < a href = "/faq/" > FAQ< / a > < / li >
2021-07-04 19:14:32 +02:00
< / ul >
< / li >
< li >
< p > Joplin API - Get Started< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/api/overview/" > Joplin API Overview< / a > < / li >
< li > < a href = "/api/get_started/plugins/" > Plugin development< / a > < / li >
< li > < a href = "/api/tutorials/toc_plugin/" > Plugin tutorial< / a > < / li >
2021-07-04 19:14:32 +02:00
< / ul >
< / li >
< li >
< p > Joplin API - References< / p >
< ul >
< li > < a href = "https://joplinapp.org/api/references/plugin_api/classes/joplin.html" > Plugin API< / a > < / li >
2021-07-10 12:22:31 +02:00
< li > < a href = "/api/references/rest_api/" > Data API< / a > < / li >
< li > < a href = "/api/references/plugin_manifest/" > Plugin manifest< / a > < / li >
< li > < a href = "/api/references/plugin_loading_rules/" > Plugin loading rules< / a > < / li >
< li > < a href = "/api/references/plugin_theming/" > Plugin theming< / a > < / li >
2021-07-04 19:14:32 +02:00
< / ul >
< / li >
< li >
< p > Development< / p >
< ul >
< li > < a href = "https://github.com/laurent22/joplin/blob/dev/BUILD.md" > How to build the apps< / a > < / li >
2021-07-10 12:22:31 +02:00
< li > < a href = "/spec/e2ee/" > End-to-end encryption spec< / a > < / li >
< li > < a href = "/spec/history/" > Note History spec< / a > < / li >
< li > < a href = "/spec/sync_lock/" > Sync Lock spec< / a > < / li >
< li > < a href = "/spec/plugins/" > Plugin Architecture spec< / a > < / li >
< li > < a href = "/spec/search_sorting/" > Search Sorting spec< / a > < / li >
< li > < a href = "/spec/server_file_url_format/" > Server: File URL Format< / a > < / li >
< li > < a href = "/spec/server_delta_sync/" > Server: Delta Sync< / a > < / li >
< li > < a href = "/spec/server_sharing/" > Server: Sharing< / a > < / li >
2021-07-04 19:14:32 +02:00
< / ul >
< / li >
< li >
< p > Google Summer of Code 2021< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/gsoc2021/index/" > Google Summer of Code 2021< / a > < / li >
< li > < a href = "/gsoc2021/pull_request_guidelines/" > How to submit a GSoC pull request< / a > < / li >
< li > < a href = "/gsoc2021/ideas/" > Project Ideas< / a > < / li >
2021-07-04 19:14:32 +02:00
< / ul >
< / li >
< li >
< p > About< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/changelog/" > Changelog (Desktop App)< / a > < / li >
< li > < a href = "/changelog_cli/" > Changelog (CLI App)< / a > < / li >
< li > < a href = "/changelog_server/" > Changelog (Server)< / a > < / li >
< li > < a href = "/stats/" > Stats< / a > < / li >
< li > < a href = "/donate/" > Donate< / a > < / li >
2021-07-04 19:14:32 +02:00
< / ul >
< / li >
< / ul >
< / div > < / div >
2021-07-10 12:22:31 +02:00
< div >
< p class = "light-blue mobile-menu-link-bottom text-center" >
2021-07-16 18:14:56 +02:00
Copyright © 2016-2021 Laurent Cozic
2021-07-10 12:22:31 +02:00
< br / >
< a href = "/privacy/" class = "fw500" > Privacy Policy< / a >
< / p >
2021-07-04 19:14:32 +02:00
< / div >
< / div >
< / div >
2021-07-10 12:22:31 +02:00
< / div >
< / div >
< / div >
2021-07-04 19:14:32 +02:00
< div class = "page-container page-clipper" >
< div class = "container" >
< div class = "row content-wrapper" >
< div id = "toc" > < div > < ul >
2021-05-24 01:16:43 +02:00
< li >
< p > Applications< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/desktop/" > Desktop application< / a > < / li >
< li > < a href = "/mobile/" > Mobile applications< / a > < / li >
< li > < a href = "/terminal/" > Terminal application< / a > < / li >
< li > < a href = "/clipper/" > Web Clipper< / a > < / li >
2021-05-24 01:16:43 +02:00
< / ul >
< / li >
< li >
< p > Support< / p >
< ul >
< li > < a href = "https://discourse.joplinapp.org" > Joplin Forum< / a > < / li >
2021-07-10 12:22:31 +02:00
< li > < a href = "/markdown/" > Markdown Guide< / a > < / li >
< li > < a href = "/e2ee/" > How to enable end-to-end encryption< / a > < / li >
< li > < a href = "/conflict/" > What is a conflict?< / a > < / li >
< li > < a href = "/debugging/" > How to enable debug mode< / a > < / li >
< li > < a href = "/rich_text_editor/" > About the Rich Text editor limitations< / a > < / li >
< li > < a href = "/faq/" > FAQ< / a > < / li >
2021-05-24 01:16:43 +02:00
< / ul >
< / li >
< li >
< p > Joplin API - Get Started< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/api/overview/" > Joplin API Overview< / a > < / li >
< li > < a href = "/api/get_started/plugins/" > Plugin development< / a > < / li >
< li > < a href = "/api/tutorials/toc_plugin/" > Plugin tutorial< / a > < / li >
2021-05-24 01:16:43 +02:00
< / ul >
< / li >
< li >
< p > Joplin API - References< / p >
< ul >
< li > < a href = "https://joplinapp.org/api/references/plugin_api/classes/joplin.html" > Plugin API< / a > < / li >
2021-07-10 12:22:31 +02:00
< li > < a href = "/api/references/rest_api/" > Data API< / a > < / li >
< li > < a href = "/api/references/plugin_manifest/" > Plugin manifest< / a > < / li >
< li > < a href = "/api/references/plugin_loading_rules/" > Plugin loading rules< / a > < / li >
< li > < a href = "/api/references/plugin_theming/" > Plugin theming< / a > < / li >
2021-05-24 01:16:43 +02:00
< / ul >
< / li >
< li >
< p > Development< / p >
< ul >
< li > < a href = "https://github.com/laurent22/joplin/blob/dev/BUILD.md" > How to build the apps< / a > < / li >
2021-07-10 12:22:31 +02:00
< li > < a href = "/spec/e2ee/" > End-to-end encryption spec< / a > < / li >
< li > < a href = "/spec/history/" > Note History spec< / a > < / li >
< li > < a href = "/spec/sync_lock/" > Sync Lock spec< / a > < / li >
< li > < a href = "/spec/plugins/" > Plugin Architecture spec< / a > < / li >
< li > < a href = "/spec/search_sorting/" > Search Sorting spec< / a > < / li >
< li > < a href = "/spec/server_file_url_format/" > Server: File URL Format< / a > < / li >
< li > < a href = "/spec/server_delta_sync/" > Server: Delta Sync< / a > < / li >
< li > < a href = "/spec/server_sharing/" > Server: Sharing< / a > < / li >
2021-05-24 01:16:43 +02:00
< / ul >
< / li >
< li >
< p > Google Summer of Code 2021< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/gsoc2021/index/" > Google Summer of Code 2021< / a > < / li >
< li > < a href = "/gsoc2021/pull_request_guidelines/" > How to submit a GSoC pull request< / a > < / li >
< li > < a href = "/gsoc2021/ideas/" > Project Ideas< / a > < / li >
2021-05-24 01:16:43 +02:00
< / ul >
< / li >
< li >
< p > About< / p >
< ul >
2021-07-10 12:22:31 +02:00
< li > < a href = "/changelog/" > Changelog (Desktop App)< / a > < / li >
< li > < a href = "/changelog_cli/" > Changelog (CLI App)< / a > < / li >
< li > < a href = "/changelog_server/" > Changelog (Server)< / a > < / li >
< li > < a href = "/stats/" > Stats< / a > < / li >
< li > < a href = "/donate/" > Donate< / a > < / li >
2021-05-24 01:16:43 +02:00
< / ul >
< / li >
< / ul >
2021-07-04 19:14:32 +02:00
< / div > < / div >
2021-05-24 01:16:43 +02:00
2021-07-04 19:14:32 +02:00
< div class = "main-content" >
2021-07-10 12:22:31 +02:00
< div class = "alert alert-danger alert-env-dev" role = "alert" >
Running in prod mode!
< / div >
< div class = "donate-links" >
< p > < a href = "https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=E8JMYD2LQ8MMA&lc=GB&item_name=Joplin+Development&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted" > < img src = "https://joplinapp.org/images/badges/Donate-PayPal-green.svg" alt = "Donate using PayPal" > < / a > < a href = "https://github.com/sponsors/laurent22/" > < img src = "https://joplinapp.org/images/badges/GitHub-Badge.svg" alt = "Sponsor on GitHub" > < / a > < a href = "https://www.patreon.com/joplin" > < img src = "https://joplinapp.org/images/badges/Patreon-Badge.svg" alt = "Become a patron" > < / a > < a href = "https://joplinapp.org/donate/#donations" > < img src = "https://joplinapp.org/images/badges/Donate-IBAN.svg" alt = "Donate using IBAN" > < / a > < / p >
< / div >
2021-05-24 01:16:43 +02:00
< h1 > Joplin Web Clipper< a name = "joplin-web-clipper" href = "#joplin-web-clipper" class = "heading-anchor" > 🔗< / a > < / h1 >
< p > The Web Clipper is a browser extension that allows you to save web pages and screenshots from your browser. To start using it, open the Joplin desktop application, go to the < strong > Web Clipper Options< / strong > and follow the instructions.< / p >
< img src = "https://joplinapp.org/images/WebExtensionScreenshot.png" style = "max-width: 50%; border: 1px solid gray;" >
< h1 > Troubleshooting the web clipper service< a name = "troubleshooting-the-web-clipper-service" href = "#troubleshooting-the-web-clipper-service" class = "heading-anchor" > 🔗< / a > < / h1 >
< p > The web clipper extension and the Joplin application communicates via a service, which is started by the Joplin desktop app.< / p >
< p > However certain things can interfere with this service and prevent it from being accessible or from starting. If something does not work, check the following:< / p >
< ul >
< li > Check that the service is started. You can check this in the Web clipper options in the desktop app.< / li >
< li > Check that the port used by the service is not blocked by a firewall. You can find the port number in the Web clipper options in the desktop Joplin application.< / li >
< li > Check that no proxy is running on the machine, or make sure that the requests from the web clipper service are filtered and allowed. For example < a href = "https://github.com/laurent22/joplin/issues/561#issuecomment-392220191" > https://github.com/laurent22/joplin/issues/561#issuecomment-392220191< / a > < / li >
< / ul >
< p > If none of this work, please report it on the < a href = "https://discourse.joplinapp.org/" > forum< / a > or < a href = "https://github.com/laurent22/joplin/issues" > GitHub issue tracker< / a > < / p >
< h1 > Debugging the extension< a name = "debugging-the-extension" href = "#debugging-the-extension" class = "heading-anchor" > 🔗< / a > < / h1 >
< h2 > In Chrome< a name = "in-chrome" href = "#in-chrome" class = "heading-anchor" > 🔗< / a > < / h2 >
< p > To provide as much information as possible when reporting an issue, you may provide the log from the various Chrome console.< / p >
< p > To do so, first enable developer mode in < a href = "chrome://extensions/" > chrome://extensions/< / a > < / p >
< ul >
< li > Debugging the popup: Right-click on the Joplin extension icon, and select " Inspect popup" .< / li >
< li > Debugging the background script: In < code > chrome://extensions/< / code > , click on " Inspect background script" .< / li >
< li > Debugging the content script: Press Ctrl+Shift+I to open the console of the current page.< / li >
< / ul >
< h2 > In Firefox< a name = "in-firefox" href = "#in-firefox" class = "heading-anchor" > 🔗< / a > < / h2 >
< ul >
< li > Open < a href = "about:debugging" > about:debugging< / a > in Firefox.< / li >
< li > Make sure the checkox " Enable add-on debugging" is ticked.< / li >
< li > Scroll down to the Joplin Web Clipper extension.< / li >
< li > Click on " Debugging" - that should open a new console window.< / li >
< / ul >
< p > Also press F12 to open the regular Firefox console (some messages from the Joplin extension can go there too).< / p >
< p > Now use the extension as normal and replicate the bug you're having.< / p >
< p > Copy and paste the content of both the debugging window and the Firefox console, and post it to the < a href = "https://discourse.joplinapp.org/" > forum< / a > .< / p >
< h1 > Using the Web Clipper service< a name = "using-the-web-clipper-service" href = "#using-the-web-clipper-service" class = "heading-anchor" > 🔗< / a > < / h1 >
< p > The Web Clipper service can be used to create, modify or delete notes, notebooks, tags, etc. from any other application. It exposes an API with a number of methods to manage Joplin's data. For more information about this API and how to use it, please check the < a href = "https://joplinapp.org/api/references/rest_api/" > Joplin API documentation< / a > .< / p >
2021-07-10 12:22:31 +02:00
< div class = "bottom-links" >
< a href = "https://github.com/laurent22/joplin/blob/dev/readme/clipper.md" >
< i class = "fab fa-github" > < / i > Improve this doc
< / a >
< / div >
2021-07-04 19:14:32 +02:00
< / div >
< / div >
< / div >
< / div >
< footer class = "darkblue-bg" >
< div class = "container" >
< div class = "row" >
< div class = "col-3 d-none d-md-block" >
< img src = "/images/logo-text.svg" alt = "" width = "150" / >
< / div >
< / div >
< div class = "row" >
< div class = "col-12" >
< hr / >
< / div >
< / div >
< div class = "row" >
< div class = "col-12 col-md-6" >
< img
src="/ images/logo-text.svg"
width="120"
class="img-center d-block d-md-none"
alt=""
/>
< br class = "d-block d-md-none" / >
2021-07-16 18:14:56 +02:00
< p class = "text-center-sm" > Copyright © 2016-2021 Laurent Cozic< / p >
2021-07-04 19:14:32 +02:00
< / div >
< div class = "col-12 col-md-6 right-links" >
< p class = "text-right text-center-sm" >
< a href = "https://github.com/laurent22/joplin/" class = "github-link" > < i class = "fab fa-github" > < / i > GitHub Repository< / a >
< a href = "/privacy/" > Privacy Policy< / a >
< / p >
< / div >
< / div >
< / div >
< / footer >
2021-05-24 01:16:43 +02:00
< / div >
2021-07-04 19:14:32 +02:00
< script
src="/ js/jquery-3.6.0.min.js"
rel="preload"
as="script"
>< / script >
2021-07-16 18:14:56 +02:00
< script src = "/js/script.js?t=1626452079487" > < / script >
2021-05-24 01:16:43 +02:00
2021-07-10 12:22:31 +02:00
< script >
2021-07-16 18:14:56 +02:00
if (window.location.hostname !== 'localhost') {
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-103586105-1', 'auto');
ga('send', 'pageview');
}
2021-07-10 12:22:31 +02:00
< / script > < / body >
2021-05-24 01:16:43 +02:00
< / html >