knowclip

KO | EN

gitlite — search

#react #typescript #llm #go #golang #machine-learning #nodejs #java #windows #awesome #cli #awesome-list #security #open-source

(★ 126)

Quickly make Anki flashcards from video and audio files, with handy features like silence detection and subtitles integration.

knowclip Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Knowclip
![GitHub](https://img.shields.io/github/license/knowclip/knowclip) [![Linux Node CI](https://github.com/knowclip/knowclip/actions/workflows/linux.yml/badge.svg)](https://github.com/knowclip/knowclip/actions/workflows/linux.yml) [![MacOS Node CI](https://github.com/knowclip/knowclip/actions/workflows/macos.yml/badge.svg)](https://github.com/knowclip/knowclip/actions/workflows/macos.yml) [![Windows Node CI](https://github.com/knowclip/knowclip/actions/workflows/windows.yml/badge.svg)](https://github.com/knowclip/knowclip/actions/workflows/windows.yml)

A cross-platform desktop application for turning audio and video files into flashcards.

It works like this:

1. Choose a media file.
2. Make your clips (manually or automatically).
3. Export your audio flashcards for use in [Anki](https://apps.ankiweb.net/).

Currently being built with [Electron](https://electronjs.org), [Vite](https://vitejs.dev/), [Redux](https://redux.js.org/) and [RxJS](https://rxjs-dev.firebaseapp.com/). Audio processing is done with [ffmpeg](https://ffmpeg.org/).

### Demo: [Making cards automatically with subtitled video](https://www.youtube.com/watch?v=mq_w2Qgikt8)
[![Knowclip](https://raw.githubusercontent.com/knowclip/knowclip/master/img/screenshot_200324.png)](https://www.youtube.com/watch?v=mq_w2Qgikt8)

### Development

To install NPM packages:

```bash
npm install
```

Once packages are installed, you may run the dev build:

```bash
npm start
```

A dev build of the Electron app will open automatically. The server will be running in the background, with Hot Module Reloading available by default, thanks to [electron-vite](https://evite.netlify.app/).

### Tests

Tests are run with [Vitest](https://vitest.dev/).

#### Unit tests

```bash
npm test
```

#### Integration tests

Integration tests use [Webdriverio](https://webdriver.io/) to make sure all the parts of the app are working together.

```bash
npm run integration
```

The disadvantage of integration tests is that they are slow to run. To speed things up while writing tests, you can run these scripts instead:

```bash
# Run integration tests
# without rebuilding the app.
# Useful if you only changed test code
npm run integration:skip-build

# Run integration tests
# without closing the app at the end.
# Lets you inspect things (e.g. with dev tools)
# in the event of a test failure.
npm run integration:debug

# run the test without building the app
# and without closing the app on completion.
# (combines debug "d" and skip-build "s")
npm run integration:ds
```

#### Test CLI options

Any arguments you pass to the test scripts will be [forwarded to Vitest](https://vitest.dev/guide/cli.html#commands).

So if you wanted to say, run just one specific test, you can do something like this:

```bash
npm test -- "reducers/clips" # target tests with "reducers/clips" in the filepath
```

#### Electron upgrade config checklist

Upgrading Electron version requires a few config files to be touched.

* Node version must be updated in:
  * [.nvmrc](./.nvmrc),
  * [.tool-versions](./.tool-versions)
  * `"engines"` in [package.json](./package.json)
  * Github workflows (Mac, Linux, and Windows)
* Electron version must be updated in:
  * [.npmrc](./.npmrc) `"browserslist"`
  * `"dependencies"` in [package.json](./package.json)
* Chromedriver version must be updated:
  * update `electron-chromedriver` in `"dependencies"` [package.json](./package.json) to match Electron version

knowclip

knowclip Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

knowclip

knowclip Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README