https://github.com/hitblast/trimsec
Track saved time when you watch your videos with multipliers on.
https://github.com/hitblast/trimsec
cargo cli-app cli-tool command-line-tool rust rust-lang time-management time-tracker
Last synced: 3 months ago
JSON representation
Track saved time when you watch your videos with multipliers on.
- Host: GitHub
- URL: https://github.com/hitblast/trimsec
- Owner: hitblast
- License: mit
- Created: 2024-12-22T12:18:31.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-09-25T06:58:07.000Z (4 months ago)
- Last Synced: 2025-09-25T08:42:38.410Z (4 months ago)
- Topics: cargo, cli-app, cli-tool, command-line-tool, rust, rust-lang, time-management, time-tracker
- Language: Rust
- Homepage: https://crates.io/crates/trimsec
- Size: 457 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 
trimsec
[](https://github.com/hitblast/trimsec/actions/workflows/tests.yml)
[](https://github.com/hitblast/trimsec/actions/workflows/release.yml)
Calculate time saved on using speed multipliers.
## Table of Contents
- [Overview](#overview)
- [Usage](#usage)
- [Installation](#installation)
- [cargo](#cargo)
- [mise](#mise)
- [Manual Installation](#manual-installation)
- [License](#license)
## Overview
I wanted a simple solution to calculate how much time I could save by using speed multipliers during lectures.
But, I did not want to hop onto the browser or even open up the calculator, or even do mind-maths for this.
Thus, I tried making a simple solution which lives in the terminal.
## Usage
To calculate saved time, you run the trim command as follows:
```bash
$ trimsec trim
```
Here, `` represents the length of the video you are watching (using
any combination of `d`, `h`, `m`, and `s`), and
`` is the speed multiplier; a float that can optionally be
suffixed with an `x` (for example, both `1.5x` and `1.5` are valid). For
instance, if you are watching a 1-hour video at 2x speed, execute:
```bash
$ trimsec trim 1h 2x
```
This command outputs the time you saved by watching the video at 2x speed. You
can also combine multiple duration indicators and apply floating-point
multipliers, such as:
```bash
$ trimsec trim 1h30m 1.5x
```
For convenience, in some cases you might use floating-point numbers for the
duration itself. For example:
```bash
# Equivalent to `2h 1.5x`.
$ trimsec trim 1.5h30m 1.5x
```
If you wish to calculate saved time for multiple durations at once using the
same speed multiplier, separate the durations with a '+' sign:
```bash
$ trimsec trim 1h30m+2h50m 1.25x
```
Each of these commands follows a consistent pattern for specifying durations and multipliers.
In addition to calculating saved time, every trim command interacts with a “time
bank” that logs the total amount of saved time per day in a JSON file. To manage
this time bank, you have several options:
- To display the current saved time for each day, use:
```bash
$ trimsec bank show
```
- To reset the time bank, run:
```bash
$ trimsec bank reset
```
- And if you want to know the absolute path to the time bank file, simply execute:
```bash
$ trimsec bank path
```
---
## Installation
### cargo
```bash
$ cargo install trimsec
```
### mise
```bash
$ mise use -g cargo:trimsec
```
## Manual Installation
Standalone binaries for this project are all available at the [GitHub
Releases](https://github.com/hitblast/trimsec/releases) page. The binaries are
produced by automated GitHub Actions workflows on three distinct runners and
should run on all their respective platforms.
For manual building, proceed with the following:
```bash
# Clone the repository.
$ git clone https://github.com/hitblast/trimsec.git
$ cd trimsec
# Output: target/release/trimsec
$ cargo build --release
```
## License
This project is licensed under the [MIT License](LICENSE).