Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mimieam/timetab

Ever wondered how long you've been hoarding a tab for?
https://github.com/mimieam/timetab

Last synced: 26 days ago
JSON representation

Ever wondered how long you've been hoarding a tab for?

Awesome Lists containing this project

README

        

## Page Time Tracker

[![GitHub Discussions](https://img.shields.io/github/discussions/mimieam/TimeTab)](https://npm.im/npx)
![GitHub repo size](https://img.shields.io/github/repo-size/mimieam/TimeTab)

> How long has this page been opened for?
> This tiny Chrome extension allows a user to see how long a tab has been open.

## Screenshots
image
imagev0.1
imagev0.5

## Getting Started
```
1. Clone this repository
2. Open `chrome://extensions` in your browser
3. Enable Developer mode if needed
4. Click "Load unpacked" and select the project folder
5. The extension will now be installed
```
or
```
npm -g npx && npm start
```

## Using the Extension
When installed, a small T icon will appear on the browser toolbar to indicate that the extension is live.

The extension UI will appear at the bottom right corner of a page when a tab is opened or reloaded

## Technical Overview
The extension uses the Browser API to get access to open tabs and windows.
- `tracking.mjs` - setup and handle events to be tracked within a page (user events, mouse move, clicks, ...etc)
- `background.mjs` - setup and handle events to be tracked on the Tab itself (when a Tab is created/loaded)
- `content.ui.mjs` contains the logic to update the ui.


Note: this extension has no bundlers & no dependencies besides npx which is installed globally.

## Roadmap
Some potential future features include:

- Notifications after certain periods
- Exporting data for reports
- Tracking across browser sessions
- Customizable view

## Known limitations
- The extension can be minimized but not dismissed from a page.
- the content when expended is too verbose

## Contributing
Pull requests are welcome! Please open an issue first to discuss any changes.

## License
The Unlicense

Please let me know if you need any part of the README expanded on or have additional questions!