Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yuis-ice/visited
Securely collect browsing history over browsers.
https://github.com/yuis-ice/visited
add-on bookmark-manager bookmarks-manager brave-browser brave-extension browser-history browsing-history chrome-browser chrome-history chromium-extension command-line-application extension-chrome firefox-extensions incognito-mode opera-addon opera-browser opera-extension self-hosted selfhosting tampermonkey-script
Last synced: about 1 month ago
JSON representation
Securely collect browsing history over browsers.
- Host: GitHub
- URL: https://github.com/yuis-ice/visited
- Owner: yuis-ice
- License: bsd-3-clause
- Created: 2021-06-23T06:14:22.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-07-16T10:52:25.000Z (over 3 years ago)
- Last Synced: 2024-10-24T21:56:28.945Z (about 2 months ago)
- Topics: add-on, bookmark-manager, bookmarks-manager, brave-browser, brave-extension, browser-history, browsing-history, chrome-browser, chrome-history, chromium-extension, command-line-application, extension-chrome, firefox-extensions, incognito-mode, opera-addon, opera-browser, opera-extension, self-hosted, selfhosting, tampermonkey-script
- Language: JavaScript
- Homepage: https://yuis-programming.com/visited-app
- Size: 27.3 KB
- Stars: 83
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-privacy - Visited - Locally collect browsing history over browsers. (Uncategorized / Imgur)
- fucking-awesome-privacy - Visited - Locally collect browsing history over browsers. (Uncategorized / Imgur)
README
# Visited-CLI
Securely collect browsing history over browsers.
## Getting started
Here is the getting started guide.
Firstly, clone the git, and change to the directory.
```
$ git clone [repo url] && cd visited
```
And install the node packages.
```
$ npm install
```
Next, generate a client program for browser. Run the following.
```
$ node visited.js --generate
✔ Port number? [default: 5555] …
File generated: ./visited.user.js
```
Now you have `visited.user.js` file generated, copy and paste the file content as your new userscript on your favorite userscript manager e.g. [tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en)
Also note that you can paste the same to your browsers, Chrome profiles, and virtually integrate browsing history at the one place.
Next, start the server. Use `-s` or `--server`. Also note that `--quiet` for background run, `--port` for specifying the port number.
```
$ node visited.js --server
```
Now you're ready. Try go to any website, let's say youtube.com, and reload page (or just visit from the omnibox).
You can see the server detects your visiting and automatically saves the URL, host, date to the database `visited.db`.
```
$ node visited.js --server
server started...
message: {"url":"https://www.youtube.com/","host":"www.youtube.com"}
```
Now you can use a sqlite client such as [DB Browser for SQLite](https://sqlitebrowser.org/dl/), or built-in searching options, just like the following.
```
$ node visited.js --search --host youtube.com
[
{
"id": 1,
"url": "https://www.youtube.com/",
"host": "www.youtube.com",
"date": "6/23/2021, 3:52:02 PM",
"timestamp": 1624431122
}
]
```
The search term is regex compatible. This shows the same result as the above.
```
$ node visited.js --search --url 'you.*be\.com'
```
## Requirements
```
git
build-essential
node
sqlite3-pcre (for searching)
```
## Help
```
$ node visited.js
Usage: visited [options]
Options:
-s, --server set command type: server
-p, --port (server) specify port number (default: 5555)
-t, --timezone (server) specify timezone (default: "Asia/Tokyo")
-q, --quiet (server) disable log
-s, --search set command type: search
-r, --regex (search) enable regex extension for search (default: true)
-u, --url (search) search by url (default: ".")
--host (search) search by host (default: ".")
--order (search) set order for search [desc, asc] (default: "desc")
--limit (search) set limit for search (default: -1)
-F, --format (search) output format [json, url] (default: "json")
--pcre-path set sqlite3 pcre file path for search (default: "/usr/lib/sqlite3/pcre.so")
-d, --database specify database file for index/search (default: "./visited.db")
--generate generates client side userScript file
--delete-database delete database
-y, --yes no confirmation prompt
-h, --help display help for command
```