schmich / marinara

Pomodoro® time management assistant for Chrome

Marinara: Pomodoro® Assistant

Marinara is a time management assistant for Chrome that follows the Pomodoro Technique.

Pomodoro® and The Pomodoro Technique® are trademarks of Francesco Cirillo. Marinara is not affiliated or associated with or endorsed by Pomodoro®, The Pomodoro Technique® or Francesco Cirillo.

Features

• Short & long breaks
• Toolbar icon with countdown timer
• Track Pomodoro history & stats
• Configurable long break intervals
• Configurable timer durations
• Desktop & tab notifications
• Audio notifications with over 20 sounds
• Ticking timer sounds
• Scheduled automatic timers
• Open source software

Screenshots

Developer Setup

Currently, Marinara is configured for developers working and packaging releases on Mac OS. Support for Linux or Windows is welcome.

Marinara uses the system ruby and make tools to build releases.

It also uses jq to manipulate the manifest.json. You can quickly install it using Homebrew:

brew install jq

Once installed you can package a release by running:

make package

This will produce a packaged extension ready for uploading to the Chrome Web Store in the root directory of the project.

License

Pomodoro® and The Pomodoro Technique® are trademarks of Francesco Cirillo. Marinara is not affiliated or associated with or endorsed by Pomodoro®, The Pomodoro Technique® or Francesco Cirillo.

Copyright © 2015 Chris Schmich
MIT License. See LICENSE for details.

marinara's Issues

Add quotes to expiration page

https://theysaidso.com/api/

Cache quotes, only update the next day.

Quote (http://api.theysaidso.com/qod.js?category=inspire):

parseResponse ({
  "meta": {
    "X-Auth-Status": "false",
    "X-RateLimit-Limit": "5 per hour",
    "X-RateLimit-Remaining": "3",
    "Access-Control-Allow-Origin": "*",
    "Access-Control-Allow-Methods": "GET,POST,PUT,OPTIONS",
    "Access-Control-Allow-Headers": "x-access-token",
    "Cache-Control": "public, max-age=43200, pre-check=86400, post-check=43200",
    "Expires": "Tue, 14 Apr 2015 02:29:22 GMT",
    "X-Powered-By": "Luracast Restler v3.0.0rc3",
    "Content-Type": "text/javascript; charset=utf-8",
    "Content-Language": "en-US"
  },
  "data": {
    "success": {
    "total": 1
  },
  "contents": {
    "id": "fNYwneMXILgcnxfxiktwTweF",
    "quote": "It's not about what you're capable of, it's about what you are willing to endure.",
    "author": "Orrin Woodward",
    "length": "81",
    "tags": [
      "endurance",
      "inspire",
      "perseverance",
      "persistence"
    ],
    "category": "inspire"
    }
  }
})

Categories (http://api.theysaidso.com/qod/categories.json):

{
  "success": {
    "total": 6
  },
  "contents": {
    "categories": {
      "funny": "Funny Quote of the day",
      "management": "Management Quote of the day",
      "sports": "Sports Quote of the day",
      "life": "Quote of the day about life",
      "inspire": "Inspiring Quote of the day",
      "love": "Quote of the day about Love"
    },
    "copyright": "2013-15 http://theysaidso.com"
  }
}

Add "When complete" label to focus/short/long break settings

• Settings page
• Each group of expiration options should be nested beneath a "When complete:" label
• Helps clarify what the options are for

Add support for long breaks

From Yasmin on Chrome Web Store review:

Is there a way to alternate between short and long breaks? That would be awesome to have!

• Focus session
• Short break session (e.g. 5 mins)
• Long break session (e.g. 10-15 mins)
• Menu entries
• Configuration for alternating between short/long breaks (e.g. every-other, every 2nd, every 3rd, etc.)

Add context menu

Add browser action context menu.

• Pause current timer
• Reset current session (break/focus)
• Start new break
• Start new focus session

Update tooltip

Browser action tooltip should update in response to state changes.

• Focusing
• Breaks
• Neutral

Update promotional screenshots

• Fix colors
• New browser menu ("Start Pomodoro Cycle")

Add ability to start a new pomodoro cycle from the main menu

Now can you right click at top tomato and click start long break & start focusing in succession and it will reset the pom cycle? I'm testing that to see if it works...Maybe please add a "Start Pomadoro Cycle," to the extension bar tomato and it will reset the cycle of 4 short breaks one long break. Thanks! And thanks for adding that cycle option!

Clicking desktop notification goes to buggy expiration page

• Settings > Uncheck "new tab" notification
• Set timer
• Click on desktop notification when it pops up
• Expiration page appears
• Message says "undefined"
• Need to fix messaging

Fix icon background transparency

Icon background should be transparent, but it's gray-ish instead. It is also non-transparent on notifications.

Update screenshots and promotional assets

• New options page
• New browser action menu
• Long breaks
• ...

Saving options shouldn't stop current session

Add features to README

• From Chrome store page
• Focus, short break, long break
• Different notifications
• ...

Add About back to options page

• See previous About section
• Licenses, attribution, authorship

Focus browser badge color should be brighter red

• Does not need to exactly match the "break" green
• Should be brighter than it currently is
• "Start Focusing" button red color on notification page should match the browser badge color

Create wiki page for usage

Remove excess shadow from icon image

Add History link to expiration page

• Footer link
• Link next to Settings link: Settings · History

Add import/export for Pomodoro history

• Since Pomodoro history is local only, we should support import/export
• JSON formatted
• Accessible from History page
• Should include version field to support back-compat importing

Add support for long breaks

• Context menu entry
• Options page setting
• Default 15 minutes?

Add ability to test settings in Options dialog

• Add a button to options dialog to test the current notification settings
• Simulates the end of a break/focus session, lets users see what it will be like

Feature: Custom Sound

Every person can select a custom sound they love, which they find suitable.

Add option to auto-start timers

From Василий on CWS (translated):

In the settings, enable continuous operation. To stop the timer, the next one automatically starts. It stimulates. You can stop the timers after a long break.

• Focus option: "When complete: Automatically start next break session"
• Break option (long/short): "When complete: Automatically start next focus session"
• Add sub-option: "Only if computer is unlocked"
• Auto-start focus after break
• Auto-start break after focus

Icon sizes should be 16, 48, 128

• See https://developer.chrome.com/apps/manifest/icons
• Update manifest.json and include 16px, 48px, 128px icons

Migrate V1 extension settings to V2

• Long break support
• Notification structure
• General migration framework

Add support for playing audio clip at end of session

• Configurable (settings)
• Separate focus/break sounds

Add option to delay break/focus session by a few minutes

After break/focus session completes, add a button to push the next session back a few minutes (3-5m).

Show how many short breaks left until next long break

• Expiration page
• Desktop notification
• Browser action menu?

Hide "Start Long Break" in browser action menu when long break is undefined

• When setting is to "never" take a long break, hide menu entry

Clicking on desktop notification should switch to expiration tab if present

• Switch to expiration tab if present
• Open expiration tab if not present

Add link from Feedback page to release notes on GitHub

• Near the extension version on the feedback page
• https://github.com/schmich/marinara/releases

Add link to contributors in Options dialog

• Link in dialog/About should go to GitHub contributors page

Add option to auto-start timer when first opening the browser

From Thamizharasan M in Chrome Web Store review:

Sometime we forget to start this timer when we open chrome. If there is an option to auto start when the chrome starts, then it will be so helpful and I have seen this feature available in other extension.

Consider using chrome.runtime.onStartup.

Make default font Segoe UI on Windows

• Currently Arial?
• -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"

Add options editor

Add options editor.

• Break time length
• Focus session length

Update promotional screenshots

• Desktop notification
• Expiration page
• Options page
• Pomodoro history

Block websites during focus sessions

Users should be able to block themselves from accessing specified websites during focus sessions.

From Justin on CWS:

Missing an important feature: blocking some websites while on a work stretch. Other tools have this. Uninstalled this.

From Delia on CWS:

How do I choose which pages to block

From Oliver on CWS:

Very useful, it could only improve if it allowed to block pages that distract like Facebook or Youtube.

From Abu on CWS:

Give the option the block selected websites of your choice. I'd also like a strict mode setting where you cannot change any of the settings until you complete a cycle.

From 하승봉 on CWS:

I would like to have a feature that automatically restricts the use of Chrome during the focus time

From HadikCZE on CWS:

Are you planning allow block all given sites while pomodor run and unblock in break ? It should boost focus mod, I now must combinate multiple extension, like Block & Focus

From Bryan on Twitter:

Just wanted to suggest an implementation of a website-blocking feature during the 25m sessions for future releases!

From Jaafer on CWS:

5 stars after blocked websites are added.

From CWS (translated):

It is good but it can be improved by implementing the blocking of sites

From Elton on CWS (translated):

I liked the plugin interface, but it would be better if you did something to block the sites, like other pomodoros that have around here ... It would be perfect.

From kuqadk3 in #189:

Hope you guys will add black-list site block so that user can import their list of sites they want to block when on pomodoro like :facebook,youtube,etc...

From tutitran in #189:

i actually think it's incredibly useful. the whole point of having a pomodoro is to block out distractions. if a user sees a reminder that these websites are blocked, they would go back to their websites.

From eric13500 in #269:

The "Tomato Timer" Google extension allows the blocking of disruptive sites during work periods (Facebook, Twitter, etc.) by listing them separated by commas (facebook.com, twitter.com). This option is very useful, and it would be very interesting that Marinara proposes it too.

Implementation notes:

• New section in settings to specify websites in a list or textarea
• Domain wildcards? Only use apex domains?
• Support comma/newline/tab/semicolon-separated lists
• Sync or local storage? Sync storage limits capacity
• What if focus session is paused?
• Create custom page to notify user when they try to access excluded websites
• Link to extension settings from blocked page
• Use optional permissions? https://developer.chrome.com/extensions/permissions
• See declarativeNetRequest Chrome API

Refresh history page on Pomodoro completion

• Only when focus session ends
• Need signal from background page
• Update history stats

"Start Break" button on notification page should be darker green

• Color should match the browser badge color

Add link to options page from expiration pages

Chromic icon

A chromatic icon that sits well on the toolbar would be eye-catching!

Add version to local storage

• Supports versioning
• e.g. { pomodoros: [...], version: 1 }

Track Pomodoro completion history/stats

You can add a counter of how many pomodoros finished on a day.

Add desktop notification to expirations

Use Chrome desktop notifications when focus/break expires.

Add options UI for showing notification & expiration page

Starting timer should immediately dismiss desktop notification

Open new tab if we're auto-closing the only open tab

• Let session expire
• Close all other tabs except expiration tab
• Click "Begin Focusing"/"Begin Break" button
• Notice all windows are now gone
• We should open a new, blank tab in this case

Add "Quick Timer" to context menu

Add ability for user to set a one-shot timer (break or focus) for a custom amount of time.

Add "View History" browser action menu entry

• Add below "Start X" timer entries
• Goes to Pomodoro History page

Break label on toolbar icon should be darker green

Current green is almost neon, makes it hard to read time remaining in break. Make the green darker.

Changing options resets Pomdoro phase

• Get to break phase, do not click timer
• Change settings (anything different)
• Click timer
• Phase has been reset to focus (skips break)
• Need to preserve phase when changing settings