Skip to main content

timekill

Build Code style: black Typechecking: mypy

A better way to kill time.

An app that suggests healthy ways for you to spend your time, in a context-aware way.

Note This project is a work-in-progress.

Features:

  • A day-planner that suggests activities for you to do

    • Taking into account context like time, activity type (work, leisure, etc.), and location.
    • When configured with activities and the conditions for recommending them, can help you sort out what to do with your days.
  • A recommender system for content that you control.

    • Gets content from reddit (later Twitter, Hacker News, etc.)
    • Includes WIP/experimental content classification/recommendation based on GPT-3.

Usage

$ timekill --help
Usage: timekill [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  list     List content with recommendations.
  plan     Plan a day of activity.
  start    Entrypoint for the timekill server
  suggest  Suggest activities to do.

Note: the text below was written a long time ago, and does not represent the current state of the project.

Why?

Most of us are guilty of using our phones too much, which wouldn't be a problem if most of the use was actually healthy. Instead we spend far more time than we should on social media, YouTube, Netflix, and games. What if we could wire our brains to compulsively open an app that suggested healthy alternatives instead?

What I suggest is a feed that serves cards with healthy and productive content. Content feeds are powerful tools that capture our attention by exploiting our brains' desire for novelty. The question is: can we tame it?

Healthy timekill

Here's a list of healthy ways to kill time:

  • Work on a task on your TODO list
  • Use learning apps like Brilliant/Khan Academy/Coursera/EdX/Duolingo
  • Work out at home or go to the gym
  • Get only the most useful/recommended content across feeds (see my wiki on The Importance of Open Recommender Systems)
    • Can this actually decrease FOMO meaningfully?
  • Staying in touch with friends we haven't talked to in a while (as some personal relationship management systems aim to help the user do)

The important thing for things to make a list like this is that it's something the user could sometimes actually be willing to do. Different times/moods/places call for different timekill.

Ideas

  • Integrate with ActivityWatch
    • Track how many productive hours timekill helped initiate.
    • Show a card with the number of productive hours today
      • You could do the same for unproductive hours, but I'm not sure that would be very helpful as it basically just shames the user (which could lead to counterproductive results)
  • Add rewards for productive time (this might be a bad idea, would make the motivation extrinsic)
  • Distraction-distracting notifications: Try to distract the user from undesirable activities (social media, games, etc.) by sending notifications that suggest healthier alternatives

Timeline

Pre-MVP

  • Build a CLI-version of the app (for quick iteration on new features)
  • Build a very basic web frontend? (for quick GUI iteration)

MVP

How do we build an MVP that users like and find helpful as quickly as possible?

  • Needs a way to configure your own activities
    • How do we get the user to think about good ways to kill time? Offer suggestions/good defaults?
  • Make it usable from phone
  • (optional) Integrate with ActivityWatch for better context-awareness

Marketing

  • Set up a ProductHunt ship page (to build a mailing list of people who are interested)
    • Link from personal, ActivityWatch, and Thankful accounts on social media
    • Share in local college/programming/startup communities (Code@LTH, D-sektionen community, Lund Startups, Malmö Startups)

Name

Current name was just how the one I happened to impulsively use when thinking about it. It might need improvement.

Similar software

I've discovered similar software that does part of what timekill does.

Automatic scheduling:

Self-hosted/open-source/personal recommender system:

  • None?

Metadata

Release files for timekill 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for timekill 0.1.0
File Size Uploaded Provenance
timekill-0.1.0.tar.gz 16.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for timekill 0.1.0
File Interpreter ABI Platform
timekill-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 35.1 kB

Release files / timekill-0.1.0.tar.gz

Download URL timekill-0.1.0.tar.gz
Size 16.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f07c1b61d651b5d9d8b0b75fa29f6b00f15b262308eac4c941d75065314a4301
BLAKE2b-256 checksum
How to use checksums
a4a0b6aa2e48d70239f330ff7a43b95c2eac18b4e7f74a7add8ff7260a6b2f81
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.2.2 CPython/3.10.6 Darwin/21.6.0

Release files / timekill-0.1.0-py3-none-any.whl

Download URL timekill-0.1.0-py3-none-any.whl
Size 18.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
899ff6a98ec4310beef6aebad7f11de484452ebaefab534f62530d2e01a4f324
BLAKE2b-256 checksum
How to use checksums
afcb057c06209bfa2cc81e9bd467e11742b030d389467151d39a16a79c449e60
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.2.2 CPython/3.10.6 Darwin/21.6.0

Security for timekill 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page