lossless-cut/developer-notes.md

## Development

This app is built using Electron.
Make sure you have at least Node v14. The app uses ffmpeg from PATH when developing.

```bash
npm install -g yarn
```

```bash
git clone https://github.com/mifi/lossless-cut.git
cd lossless-cut
yarn
```
Note: `yarn` may take some time to complete.

### Installing `ffmpeg`

Run one of the below commands:
```bash
npm run download-ffmpeg-darwin-x64
npm run download-ffmpeg-darwin-arm64
npm run download-ffmpeg-linux-x64
npm run download-ffmpeg-win32-x64
```

### Running

```bash
npm start
```

### Building for production

See:
- https://www.electron.build/
- https://github.com/mifi/lossless-cut/blob/master/.github/workflows/build.yml

## Building mas-dev (Mac App Store) build locally

This will sign using the development provisioning profile:

```
npm run pack-mas-dev
```

## Windows Store

Windows store version is built as a Desktop Bridge app (with `runFullTrust` capability). This means the app has access to essentially everything the user has access to, and even `internetClient` is redundant.

- https://learn.microsoft.com/en-us/windows/uwp/packaging/app-capability-declarations
- https://learn.microsoft.com/en-us/archive/blogs/appconsult/a-simpler-and-faster-way-to-publish-your-desktop-bridge-applications-on-the-microsoft-store
- https://stackoverflow.com/a/52921641/6519037

## Releasing

For per-platform build/signing setup, see [this article](https://mifi.no/blog/automated-electron-build-with-release-to-mac-app-store-microsoft-store-snapcraft/).

### Release new version

- Commit changes
- `npm version ...`
- `git push && git push --tags`
- Wait for build and draft in Github actions
- Release draft at github
- Bump [snap version](https://snapcraft.io/losslesscut/listing)
- `npm run scan-i18n` to get the newest Englist strings and push so weblate gets them

## Maintainence chores

### Keep dependencies up to date
- ffmpeg
- electron
- package.json

### i18n
`npm run scan-i18n`

### Licenses

#### Generate summary

```
npx license-checker --summary
```

#### Regenerate licenses file

```
npm run generate-licenses
#cp licenses.txt losslesscut.mifi.no/public//
```
Then deploy.
Update developer-notes.md 4 years ago			`## Development`
update readme 6 years ago
Update developer-notes.md 6 years ago			`This app is built using Electron.`
improve dev notes 5 years ago			`Make sure you have at least Node v14. The app uses ffmpeg from PATH when developing.`
Update developer-notes.md 6 years ago
			```bash
			`npm install -g yarn`
update readme 6 years ago			```
Update developer-notes.md 6 years ago
			```bash
update readme 6 years ago			`git clone https://github.com/mifi/lossless-cut.git`
			`cd lossless-cut`
update dev notes 6 years ago			`yarn`
update readme 6 years ago			```
Update developer-notes.md 6 years ago			Note: `yarn` may take some time to complete.
update readme 6 years ago
Update developer-notes.md 4 years ago			### Installing `ffmpeg`
Update developer-notes.md 4 years ago
			`Run one of the below commands:`
add note about runing on mac #790 5 years ago			```bash
try to support apple silicon 4 years ago			`npm run download-ffmpeg-darwin-x64`
			`npm run download-ffmpeg-darwin-arm64`
			`npm run download-ffmpeg-linux-x64`
			`npm run download-ffmpeg-win32-x64`
Update developer-notes.md 4 years ago			```
update dev notes 6 years ago
Update developer-notes.md 4 years ago			`### Running`

			```bash
update readme 6 years ago			`npm start`
			```

Update developer-notes.md 4 years ago			`### Building for production`

			`See:`
			`- https://www.electron.build/`
			`- https://github.com/mifi/lossless-cut/blob/master/.github/workflows/build.yml`

			`## Building mas-dev (Mac App Store) build locally`
improve dev notes 5 years ago
			`This will sign using the development provisioning profile:`

			```
			`npm run pack-mas-dev`
			```

Update developer-notes.md 4 years ago			`## Windows Store`

			Windows store version is built as a Desktop Bridge app (with `runFullTrust` capability). This means the app has access to essentially everything the user has access to, and even `internetClient` is redundant.

			`- https://learn.microsoft.com/en-us/windows/uwp/packaging/app-capability-declarations`
			`- https://learn.microsoft.com/en-us/archive/blogs/appconsult/a-simpler-and-faster-way-to-publish-your-desktop-bridge-applications-on-the-microsoft-store`
			`- https://stackoverflow.com/a/52921641/6519037`

			`## Releasing`
improve readme 8 years ago
Update developer-notes.md 4 years ago			`For per-platform build/signing setup, see [this article](https://mifi.no/blog/automated-electron-build-with-release-to-mac-app-store-microsoft-store-snapcraft/).`
improve dev notes 5 years ago
improve readme 8 years ago			`### Release new version`

fix typo 4 years ago			`- Commit changes`
use github actions for building will add snap later 7 years ago			- `npm version ...`
			- `git push && git push --tags`
			`- Wait for build and draft in Github actions`
			`- Release draft at github`
update dev notes 5 years ago			`- Bump [snap version](https://snapcraft.io/losslesscut/listing)`
update devnotes 5 years ago			- `npm run scan-i18n` to get the newest Englist strings and push so weblate gets them
add licenses 5 years ago
improve devnotes 5 years ago			`## Maintainence chores`
add licenses 5 years ago
improve devnotes 5 years ago			`### Keep dependencies up to date`
			`- ffmpeg`
			`- electron`
			`- package.json`

			`### i18n`
			`npm run scan-i18n`

			`### Licenses`

			`#### Generate summary`
add licenses 5 years ago
			```
			`npx license-checker --summary`
			```

improve devnotes 5 years ago			`#### Regenerate licenses file`
add licenses 5 years ago
			```
			`npm run generate-licenses`
update licenses path 4 years ago			`#cp licenses.txt losslesscut.mifi.no/public//`
add licenses 5 years ago			```
improve devnotes 5 years ago			`Then deploy.`