Skip to content

Commit 7ad0f49

Browse files
authored
Refresh documents (README.md and our site) (#676)
1 parent e0da801 commit 7ad0f49

26 files changed

+700
-373
lines changed

README.md

Lines changed: 16 additions & 116 deletions
Original file line numberDiff line numberDiff line change
@@ -2,34 +2,31 @@
22

33
<div align="center">
44

5-
[![GitHub](https://img.shields.io/github/license/locaal-ai/obs-backgroundremoval)](https://github.com/locaal-ai/obs-backgroundremoval/blob/main/LICENSE)
6-
[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/locaal-ai/obs-backgroundremoval/push.yaml)](https://github.com/locaal-ai/obs-backgroundremoval/actions/workflows/push.yaml)
7-
[![Total downloads](https://img.shields.io/github/downloads/locaal-ai/obs-backgroundremoval/total)](https://github.com/locaal-ai/obs-backgroundremoval/releases)
5+
[![GitHub](https://img.shields.io/github/license/royshil/obs-backgroundremoval)](https://github.com/royshil/obs-backgroundremoval/blob/main/LICENSE)
6+
[![GitHub Workflow Status](https://github.com/royshil/obs-backgroundremoval/actions/workflows/push.yaml/badge.svg)](https://github.com/royshil/obs-backgroundremoval/actions/workflows/push.yaml)
7+
[![Total downloads](https://img.shields.io/github/downloads/royshil/obs-backgroundremoval/total)](https://github.com/royshil/obs-backgroundremoval/releases)
88
![Flathub](https://img.shields.io/flathub/downloads/com.obsproject.Studio.Plugin.BackgroundRemoval?label=Flathub%20Installs)
9-
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/locaal-ai/obs-backgroundremoval)](https://github.com/locaal-ai/obs-backgroundremoval/releases)
10-
[![Discord](https://img.shields.io/discord/1200229425141252116)](https://discord.gg/KbjGU2vvUz)
9+
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/royshil/obs-backgroundremoval)](https://github.com/royshil/obs-backgroundremoval/releases)
1110

1211
</div>
1312

1413
A plugin for [OBS Studio](https://obsproject.com/) that allows you to replace the background in portrait images and video, as well as enhance low-light scenes.
1514

16-
- [Usage](#usage)
17-
- [Download](#download)
18-
- [Introduction](#introduction)
19-
- [Building](#building)
20-
- [MacOSX](#mac-osx)
21-
- [Linux (Ubuntu, Arch, openSUSE, Fedora)](#linux)
22-
- [Windows](#windows)
15+
<p align="center">
16+
<a href="https://royshil.github.io/obs-backgroundremoval/">
17+
<b>⬇️ Download & Install OBS Background Removal ⬇️</b>
18+
</a>
19+
</p>
2320

24-
For other AI plugins from us check out [locaal AI](https://github.com/locaal-ai).
21+
Or, browse versions on [releases page](https://github.com/royshil/obs-backgroundremoval/releases).
2522

2623
## Usage
2724

28-
<div align="center">
25+
<div style="text-align:center;">
2926
<video src="https://github.com/locaal-ai/obs-backgroundremoval/assets/1067855/5ba5aae2-7ea2-4c90-ad45-fba5ccde1a4e" width="320"></video>
3027
</div>
3128

32-
Check out the [usage guide page](https://locaal-ai.github.io/obs-backgroundremoval/usage) for usage walkthrough and recommendations.
29+
Check out the [usage guide page](https://royshil.github.io/obs-backgroundremoval/usage/) for usage walkthrough and recommendations.
3330

3431
Additional tutorial videos:
3532

@@ -38,41 +35,6 @@ Additional tutorial videos:
3835
- Low-light enhancement: https://youtu.be/WSBLYWFrn2Q
3936
- Remove background from ANY object (not just human): https://youtu.be/N74VCDCToX8
4037

41-
## Download
42-
43-
Check out the [guide page](https://royshil.github.io/obs-backgroundremoval/) for downloads and install instructions for **Windows** and **MacOS**.
44-
45-
### Linux Installation
46-
47-
On Ubuntu, there are two ways to install OBS and you have to use the corresponding method to install this plugin.
48-
49-
- If you installed OBS via the official PPA, download the deb package from the [releases](https://github.com/locaal-ai/obs-backgroundremoval/releases) page and install it directly.
50-
- If you installed OBS via FlatHub, run the following command: `flatpak install com.obsproject.Studio.Plugin.BackgroundRemoval`
51-
52-
The pre-built binary of this plugin can run Ubuntu 22.04 or later.
53-
54-
On openSUSE, please see [`docs/BUILDING-OPENSUSE.md`](docs/BUILDING-OPENSUSE.md).
55-
56-
#### FlatHub
57-
58-
On Debian, you cannot use our deb package and we only support FlatHub installation.
59-
60-
On other Linux distros, use the FlatHub installation of both OBS and this plugin.
61-
62-
```
63-
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
64-
flatpak install flathub com.obsproject.Studio
65-
flatpak install flathub com.obsproject.Studio.Plugin.BackgroundRemoval
66-
```
67-
68-
If you install OBS in a way other than FlatHub, you have to build this plugin by yourself (see instructions for building [below](#linux)).
69-
70-
### OBS Version Support and Compatibility
71-
72-
- OBS version 29+ ([download](https://obsproject.com/download)) for the latest version of this plugin, e.g. 1.1.x and above.
73-
- OBS version 28+ for this plugin's version between 0.5.x and 1.0.x.
74-
- OBS version 27+ for this plugin's version 0.4.x and below.
75-
7638
## Introduction
7739

7840
This plugin is meant to make it easy to replace the background in portrait images and video.
@@ -87,20 +49,22 @@ If you like this work, which is given to you completely free of charge, please c
8749

8850
### Support and Help
8951

90-
Reach out to us on [Discord](https://discord.gg/3EUBUjpCD3) or the [OBS Plugins forum](https://obsproject.com/forum/resources/background-removal-portrait-segmentation.1260/) for online / immediate help.
52+
Reach out to us on [GitHub Discussions](https://github.com/royshil/obs-backgroundremoval/discussions) or the [OBS Plugins forum](https://obsproject.com/forum/resources/background-removal-portrait-segmentation.1260/) for online / immediate help.
9153

92-
If you found a bug or want to suggest a feature or improvement please open an [issue](https://github.com/locaal-ai/obs-backgroundremoval/issues).
54+
If you found a bug or want to suggest a feature or improvement please open an [issue](https://github.com/royshil/obs-backgroundremoval/issues).
9355

9456
If you are looking for hands-on help or private consultation please select a [sponsorship tier](https://github.com/sponsors/royshil?frequency=one-time).
9557

9658
### Technical Details
9759

60+
<!--
9861
GPU support:
9962
10063
- Currently on Windows we support DirectML, which should reduce CPU usage by 95% and effectively use the systems accelerators (GPUs if available).
10164
- On Mac we support CoreML for acceleration, which is available on M1 and M2 (not Intel, sorry).
10265
- CUDA is supported in this plugin through TensorRT, however it is supported only on Linux.
10366
- The goal of this plugin is to be available for everyone on every system, even if they don't own a GPU.
67+
-->
10468

10569
Number of CPU threads is controllable through the UI settings. A 2-thread setting works best.
10670

@@ -132,70 +96,6 @@ This video on YouTube will take you through the major parts of the code and expl
13296
</a>
13397
</div>
13498

135-
## Building
136-
137-
The plugin was built and tested on Mac OSX (Intel & Apple silicon), Windows and several Linux disros (e.g. Ubuntu/Debian-ish, Fedora, and more). Help is appreciated in building on other OSs and packages.
138-
139-
The building pipelines in CI take care of the heavy lifting. Use them in order to build the plugin locally. We attempt to use external OpenCV, libcurl and ONNX Runtime to reduce build times.
140-
141-
Start by cloning this repo to a directory of your choice.
142-
143-
### Mac OSX
144-
145-
Using the CI pipeline scripts, locally you would just call the zsh script. By default this builds a universal binary for both Intel and Apple Silicon. To build for a specific architecture please see `.github/scripts/.build.zsh` for the `-arch` options.
146-
147-
```sh
148-
$ ./.github/scripts/build-macos -c Release
149-
```
150-
151-
#### Install
152-
153-
The above script should succeed and the plugin files (e.g. `obs-backgroundremoval.plugin`) will reside in the `./release/Release` folder off of the root. Copy the `.plugin` file to the OBS directory e.g. `~/Library/Application Support/obs-studio/plugins`.
154-
155-
To get `.pkg` installer file, run for example
156-
157-
```sh
158-
$ ./.github/scripts/package-macos -c Release
159-
```
160-
161-
(Note that maybe the outputs will be in the `Release` folder and not the `install` folder like `pakage-macos` expects, so you will need to rename the folder from `build_x86_64/Release` to `build_x86_64/install`)
162-
163-
### Linux
164-
165-
#### Ubuntu
166-
167-
Use the CI scripts again
168-
169-
```sh
170-
$ ./.github/scripts/build-linux.sh
171-
```
172-
173-
#### Arch Linux
174-
175-
The community maintains AUR packages: https://aur.archlinux.org/packages/obs-backgroundremoval
176-
177-
#### Fedora
178-
179-
To compile on Fedora, you need to manage the dependencies manually. See [docs/BUILDING-FEDORA.md](docs/BUILDING-FEDORA.md) for more information.
180-
181-
#### FlatHub
182-
183-
The plugin is available on FlatHub: https://github.com/flathub/com.obsproject.Studio.Plugin.BackgroundRemoval
184-
185-
```sh
186-
$ flatpak install com.obsproject.Studio.Plugin.BackgroundRemoval
187-
```
188-
189-
### Windows
190-
191-
Use the CI scripts again, for example:
192-
193-
```powershell
194-
> .github/scripts/Build-Windows.ps1 -Target x64 -CMakeGenerator "Visual Studio 17 2022"
195-
```
196-
197-
The build should exist in the `./release` folder off the root. You can manually install the files in the OBS directory.
198-
19999
<picture>
200100
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=locaal-ai/obs-backgroundremoval&type=Date&theme=dark" />
201101
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=locaal-ai/obs-backgroundremoval&type=Date" />

docs/UNINSTALL.md

Lines changed: 0 additions & 25 deletions
This file was deleted.

pages/src/assets/checkDll.png

-26 KB
Binary file not shown.

pages/src/assets/demo.gif

302 KB
Loading

pages/src/assets/github.svg

Lines changed: 0 additions & 16 deletions
This file was deleted.

pages/src/assets/installWizard.png

-23.1 KB
Binary file not shown.
6.31 KB
Loading
-31.7 KB
Binary file not shown.

pages/src/layouts/Layout.astro

Lines changed: 28 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,28 @@ const { BASE_URL } = import.meta.env;
4747
--color-bg-0: rgb(202, 216, 228);
4848
--color-bg-1: hsl(209, 36%, 86%);
4949
--color-bg-2: hsl(224, 44%, 95%);
50+
--color-button-1: #007acc;
51+
--color-button-2: #189cff;
52+
--color-white-box-bg: #fbfbfb;
53+
--color-box-shadow: #0000001a;
54+
}
55+
56+
main.white-box {
57+
max-width: 800px;
58+
width: 100%;
59+
margin: 1rem auto;
60+
padding: 2rem;
61+
box-sizing: border-box;
62+
overflow: visible;
63+
64+
border-radius: 8px;
65+
box-shadow: 0 4px 8px var(--color-box-shadow);
66+
67+
background-color: var(--color-white-box-bg);
68+
}
69+
70+
.astro-code {
71+
padding: 10px;
5072
}
5173
</style>
5274

@@ -60,17 +82,11 @@ const { BASE_URL } = import.meta.env;
6082

6183
html {
6284
background-attachment: fixed;
63-
background-image:
64-
radial-gradient(
65-
50% 50% at 50% 50%,
66-
rgba(255, 255, 255, 0.75) 0%,
67-
rgba(255, 255, 255, 0) 100%
68-
),
69-
linear-gradient(
70-
180deg,
71-
var(--color-bg-0) 0%,
72-
var(--color-bg-1) 15%,
73-
var(--color-bg-2) 50%
74-
);
85+
background-image: linear-gradient(
86+
180deg,
87+
var(--color-bg-0) 0%,
88+
var(--color-bg-1) 15%,
89+
var(--color-bg-2) 50%
90+
);
7591
}
7692
</style>
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
import { joinURL } from "ufo";
3+
4+
import Layout from './Layout.astro';
5+
6+
interface Props {
7+
frontmatter: {
8+
lang: string;
9+
title: string;
10+
description: string;
11+
};
12+
}
13+
14+
const { BASE_URL } = import.meta.env;
15+
const { lang, title, description } = Astro.props.frontmatter;
16+
---
17+
18+
<Layout lang={lang} title={title} description={description}>
19+
<main class="white-box">
20+
<slot />
21+
22+
<p><a href={joinURL(BASE_URL, "/")}>Back to the top page</a></p>
23+
</main>
24+
</Layout>

0 commit comments

Comments
 (0)