Skip to content

Commit b85923c

Browse files
committed
readme updated, server removed from viewer repository
1 parent ee96506 commit b85923c

8 files changed

Lines changed: 9 additions & 5553 deletions

File tree

README.md

Lines changed: 9 additions & 137 deletions
Original file line numberDiff line numberDiff line change
@@ -39,36 +39,17 @@ The project was renamed to Arcane to avoid the generic nature of the previous na
3939

4040
## Version Table
4141

42-
> ⓘ You can use any version of the viewer with any version of the server, as long as the protocol version matches. The protocol version ensures compatibility between the viewer and the server.
43-
44-
> ⓘ It is recommended to always use the latest versions of both the viewer and the server whenever possible. This ensures compatibility between the two and provides the best experience.
45-
46-
### Arcane Viewer Table
47-
48-
| Version | Protocol Version | Release Date |
49-
|-----------------|------------------|----------------|
50-
| 1.0.0b1 (Beta) | 5.0.0b1 | 01 August 2024 |
51-
| 1.0.0b2 (Beta) | 5.0.0b1 | 05 August 2024 |
52-
| 1.0.3 (Beta) | 5.0.0b1 | 12 August 2024 |
53-
| 1.0.4 (Beta) | 5.0.1 | 15 August 2024 |
54-
| 🟢 1.0.5 (Beta) | 5.0.1 | 22 August 2024 |
55-
56-
### Arcane Server Table
57-
58-
| Version | Protocol Version | Release Date |
59-
|----------------|------------------|----------------|
60-
| 1.0.0b1 (Beta) | 5.0.0b1 | 01 August 2024 |
61-
| 1.0.0b2 (Beta) | 5.0.0b1 | 05 August 2024 |
62-
| 1.0.3 | 5.0.0b1 | 12 August 2024 |
63-
| 🟢 1.0.4 | 5.0.1 | 15 August 2024 |
42+
## Version Table
6443

65-
* 🟢 Head version
44+
| Version | Protocol Version | Release Date | Compatible Servers |
45+
|---------|------------------|----------------|--------------------|
46+
| 1.0.5b | 5.0.1 | 22 August 2024 | [1.0.4](https://github.com/PhrozenIO/ArcaneServer/releases/tag/1-0-4) |
6647

67-
> Since version 1.0.4, the server version will only be updated when there are changes to the server code. It will no longer automatically reflect the latest viewer version as it did before.
48+
> You can use any version of the viewer with any version of the server, as long as the protocol version matches. The protocol version ensures compatibility between the viewer and the server.
6849
69-
## Components
50+
> ⓘ It is recommended to always use the latest versions of both the viewer and the server whenever possible. This ensures compatibility between the two and provides the best experience.
7051
71-
### Arcane Viewer
52+
## Quick Setup ([PyPi.org](https://pypi.org))
7253

7354
The recommended way to install and launch the Arcane viewer is to first create a virtual environment. This can be done using **virtualenv** as follows:
7455

@@ -98,118 +79,9 @@ arcane-viewer
9879

9980
### Arcane Server
10081

101-
#### Fast Use
102-
103-
The easiest way to install and run the server is by installing the PowerShell module from the PowerShell Gallery:
104-
105-
> Please note that you must have administrative privileges to install a new module. To do this, open an elevated PowerShell prompt and execute the following command:
106-
107-
```powershell
108-
Install-Module -Name Arcane_Server
109-
```
110-
111-
Before running the server, you must import the module into your PowerShell session:
112-
113-
> Please note that depending on your system configuration, you may need to run the following command to temporarily bypass the execution policy in order to run an unsigned script:
114-
> `powershell.exe -executionpolicy bypass`
115-
116-
```powershell
117-
Import-Module Arcane_Server
118-
```
119-
120-
Once the module is installed, you can run the server using the following command:
121-
122-
```powershell
123-
Invoke-ArcaneServer
124-
```
125-
126-
That's it, you're ready to go! 🚀
127-
128-
#### Available Module Functions
129-
130-
```powershell
131-
Invoke-ArcaneServer
132-
```
133-
134-
##### ⚙️ Supported Options:
135-
136-
| Parameter | Type | Default | Description |
137-
|------------------------|------------------|------------|--------------|
138-
| ServerAddress | String | 0.0.0.0 | IP address representing the local machine's IP address |
139-
| ServerPort | Integer | 2801 | The port number on which to listen for incoming connections |
140-
| SecurePassword | SecureString | None | SecureString object containing the password used for authenticating remote viewers (recommended) |
141-
| Password | String | None | Plain-text password used for authenticating remote viewers (not recommended; use SecurePassword instead) |
142-
| DisableVerbosity | Switch | False | If specified, the program will suppress verbosity messages |
143-
| UseTLSv1_3 | Switch | False | If specified, the program will use TLS v1.3 instead of TLS v1.2 for encryption (recommended if both systems support it) |
144-
| Clipboard | Enum | Both | Specify the clipboard synchronization mode (options include 'Both', 'Disabled', 'Send', and 'Receive'; see below for more detail) |
145-
| CertificateFile | String | None | A file containing valid certificate information (x509) that includes the private key |
146-
| EncodedCertificate | String | None | A base64-encoded representation of the entire certificate file, including the private key |
147-
| ViewOnly | Switch | False | If specified, the remote viewer will only be able to view the desktop and will not have access to the mouse or keyboard |
148-
| PreventComputerToSleep | Switch | False | If specified, this option will prevent the computer from entering sleep mode while the server is active and waiting for new connections |
149-
| CertificatePassword | SecureString | None | Specify the password used to access a password-protected x509 certificate provided by the user |
150-
151-
##### Server Address Examples
152-
153-
| Value | Description |
154-
|-------------------|--------------------------------------------------------------------------|
155-
| 127.0.0.1 | Only listen for connections from the localhost (usually for debugging purposes) |
156-
| 0.0.0.0 | Listen for connections on all network interfaces, including the local network and the internet |
157-
158-
##### Clipboard Mode Enum Properties
159-
160-
| Value | Description |
161-
|-------------------|----------------------------------------------------|
162-
| Disabled | Clipboard synchronization is disabled on both the viewer and server sides |
163-
| Receive | Only incoming clipboard data is allowed |
164-
| Send | Only outgoing clipboard data is allowed |
165-
| Both | Clipboard synchronization is allowed on both the viewer and server sides |
166-
167-
##### ⚠️ Important Notices
168-
169-
1. It is recommended to use SecurePassword instead of a plain-text password, even if the plain-text password is being converted to a SecureString.
170-
2. If you do not specify a custom certificate using 'CertificateFile' or 'EncodedCertificate', a default self-signed certificate will be generated and installed for the local user.
171-
3. If you do not specify a SecurePassword or Password, a random, complex password will be generated and displayed in the terminal (this password is temporary).
172-
173-
##### Examples
174-
175-
```powershell
176-
Invoke-ArcaneServer -ListenAddress "0.0.0.0" -ListenPort 2801 -SecurePassword (ConvertTo-SecureString -String "urCompl3xP@ssw0rd" -AsPlainText -Force)
177-
178-
Invoke-ArcaneServer -ListenAddress "0.0.0.0" -ListenPort 2801 -SecurePassword (ConvertTo-SecureString -String "urCompl3xP@ssw0rd" -AsPlainText -Force) -CertificateFile "c:\certs\phrozen.p12"
179-
```
180-
181-
##### Generate your Certificate
182-
183-
```
184-
openssl req -x509 -sha512 -nodes -days 365 -newkey rsa:4096 -keyout phrozen.key -out phrozen.crt
185-
```
186-
187-
Then export the new certificate (**must include private key**).
188-
189-
```
190-
openssl pkcs12 -export -out phrozen.p12 -inkey phrozen.key -in phrozen.crt
191-
```
192-
193-
##### Integrate to server as a file
194-
195-
Use `CertificateFile`. Example: `c:\tlscert\phrozen.crt`
196-
197-
##### Integrate to server as a base64 representation
198-
199-
Encode an existing certificate using PowerShell
200-
201-
```powershell
202-
[convert]::ToBase64String((Get-Content -path "c:\tlscert\phrozen.crt" -Encoding byte))
203-
```
204-
or on Linux / Mac systems
205-
206-
```
207-
base64 -i /tmp/phrozen.p12
208-
```
209-
210-
You can then pass the output base64 certificate file to parameter `EncodedCertificate` (One line)
82+
For detailed instructions on how to use and configure the Arcane Server, please refer to the [official Arcane Server repository](https://github.com/PhrozenIO/ArcaneServer). The repository contains comprehensive documentation, including setup guides, configuration options, and best practices for managing your server effectively.
21183

212-
## Viewer Screenshots
84+
## Screenshots
21385

21486
<p align="center">
21587
<img width="50%" src="https://raw.githubusercontent.com/PhrozenIO/Arcane/main/resources/images/screenshots/main.png" alt="Main Window"/>

arcane_server/Arcane_Server.psd1

-8.14 KB
Binary file not shown.

0 commit comments

Comments
 (0)