Update 5.0

New main features
- ServerManager
- RemoDesk protocol support
- New client system
- Supported auth with none, password and public key
- Support remote monitor for mobaxterm user (beta)
- SFTP can set specific folder for user
- Support exec_request

New function
- Send_karaoke_effect
- ShowCursor
- SendBell
- NewSend for advance sending like print()
- Flag_TH for about
- wait_inputmouse for mouse input

Fixing
- (only python) fixing can't print color
without damp11113 library or print color library only in windows on python console
- Fixing sometime can't connect SFTP

and more

Author: damp11113

README.md

@@ -1,66 +1,57 @@
 # What is PyserSSH
 
-PyserSSH is a library for remote control your code with ssh client. The aim is to provide a scriptable SSH server which can be made to behave like any SSH-enabled device.
+PyserSSH is a free and open-source Python library designed to facilitate the creation of customizable SSH terminal servers. Initially developed for research purposes to address the lack of suitable SSH server libraries in Python, PyserSSH provides a flexible and user-friendly solution for implementing SSH servers, making it easier for developers to handle user interactions and command processing.
+
+The project was started by a solo developer to create a more accessible and flexible tool for managing SSH connections and commands. It offers a simplified API compared to other libraries, such as Paramiko, SSHim, and Twisted, which are either outdated or complex for new users.
 
 This project is part from [damp11113-library](https://github.com/damp11113/damp11113-library)
 
-This Server use port **2222** for default port
+## Some small PyserSSH history
+PyserSSH version [1.0](https://github.com/DPSoftware-Foundation/PyserSSH/releases/download/Legacy/PyserSSH10.py) (real filename is "test277.py") was created in 2023/9/3 for experimental purposes only. Because I couldn't find the best ssh server library for python and I started this project only for research. But I have time to develop this research into a real library for use. In software or server.
 
-> [!WARNING]  
-> For use in product please **generate new private key**! If you still use this demo private key maybe your product getting **hacked**! up to 90%. Please don't use this demo private key for real product.
+read full history from [docs](https://damp11113.xyz/PyserSSHDocs/history.html)
 
 # Install
 Install from pypi
 ```bash
 pip install PyserSSH
 ```
-Install from github
+Install with [openRemoDesk](https://github.com/DPSoftware-Foundation/openRemoDesk) protocol
+```bash
+pip install PyserSSH[RemoDesk]
+```
+Install from Github
 ```bash
 pip install git+https://github.com/damp11113/PyserSSH.git
 ```
+Install from DPCloudev Git
+```bash
+pip install git+https://git.damp11113.xyz/DPSoftware-Foundation/PyserSSH.git
+```
 
 # Quick Example
+This Server use port **2222** for default port
 ```py
-import os
-
 from PyserSSH import Server, Send, AccountManager
 
-useraccount = AccountManager()
-useraccount.add_account("admin", "") # create user without password
-
+useraccount = AccountManager(anyuser=True)
 ssh = Server(useraccount)
 
 @ssh.on_user("command")
 def command(client, command: str):
     if command == "hello":
         Send(client, "world!")
 
-ssh.run(os.path.join(os.path.dirname(os.path.realpath(__file__)), 'private_key.pem'))
+ssh.run("your private key file")
 ```
 This example you can connect with `ssh admin@localhost -p 2222` and press enter on login
 If you input `hello` the response is `world`
 
 # Demo
-https://github.com/damp11113/PyserSSH/assets/64675096/49bef3e2-3b15-4b64-b88e-3ca84a955de7
+> [!WARNING]  
+> For use in product please **generate new private key**! If you still use this demo private key maybe your product getting **hacked**! up to 90%. Please don't use this demo private key for real product.
 
-For run this demo you can use this command
-```
-$ python -m PyserSSH
-```
-then
-```
-Do you want to run demo? (y/n): y
-```
-But if no [damp11113-library](https://github.com/damp11113/damp11113-library)
-```
-No 'damp11113-library'
-This demo is require 'damp11113-library' for run
-```
-you need to install [damp11113-library](https://github.com/damp11113/damp11113-library) for run this demo by choose `y` or `yes` in lowercase or uppercase
-```
-Do you want to install 'damp11113-library'? (y/n): y
-```
-For exit demo you can use `ctrl+c` or use `shutdown now` in PyserSSH shell **(not in real terminal)**
+https://github.com/damp11113/PyserSSH/assets/64675096/49bef3e2-3b15-4b64-b88e-3ca84a955de7
 
 I intend to leaked private key because that key i generated new. I recommend to generate new key if you want to use on your host because that key is for demo only.
 why i talk about this? because when i push private key into this repo in next 5 min++ i getting new email from GitGuardian. in that email say "

demo/Save Your Tears lyrics.srt

@@ -0,0 +1,157 @@
+0
+00:00:00,000 --> 00:00:09,200
+(Intro)
+
+1
+00:00:09,200 --> 00:00:13,100
+I saw you dancing in a crowded room
+
+2
+00:00:13,200 --> 00:00:17,200
+You look so happy when
+I'm not with you
+
+3
+00:00:17,300 --> 00:00:21,300
+But then you saw me, caught
+you by surprise
+
+4
+00:00:21,400 --> 00:00:26,200
+A single teardrop falling
+from your eye
+
+5
+00:00:26,300 --> 00:00:31,400
+I don't know why I run away
+
+6
+00:00:34,400 --> 00:00:40,900
+I'll make you cry when I run away
+
+7
+00:00:41,700 --> 00:00:45,950
+You could've asked me why
+I broke your heart
+
+8
+00:00:46,000 --> 00:00:49,800
+You could've told me
+that you fell apart
+
+9
+00:00:49,900 --> 00:00:53,700
+But you walked past me
+like I wasn't there
+
+10
+00:00:53,800 --> 00:00:58,450
+And just pretended like
+you didn't care
+
+11
+00:00:58,500 --> 00:01:03,000
+I don't know why I run away
+
+12
+00:01:06,400 --> 00:01:11,300
+I'll make you cry when I run away
+
+13
+00:01:14,700 --> 00:01:18,600
+Take me back 'cause I wanna stay
+
+14
+00:01:18,700 --> 00:01:21,600
+Save your tears for another
+
+15
+00:01:21,700 --> 00:01:28,900
+Save your tears for another day
+
+16
+00:01:29,800 --> 00:01:34,700
+Save your tears for another day
+
+17
+00:01:37,000 --> 00:01:42,900
+So, I made you think that
+I would always stay
+
+18
+00:01:43,000 --> 00:01:46,600
+I said some things that
+I should never say
+
+19
+00:01:46,700 --> 00:01:50,600
+Yeah, I broke your heart like
+someone did to mine
+
+20
+00:01:50,700 --> 00:01:55,500
+And now you won't love
+me for a second time
+
+21
+00:01:55,600 --> 00:02:00,400
+I don't know why I run away, oh, girl
+
+22
+00:02:03,300 --> 00:02:08,800
+Said I make you cry when I run away
+
+23
+00:02:11,500 --> 00:02:15,600
+Girl, take me back 'cause I wanna stay
+
+24
+00:02:15,700 --> 00:02:19,200
+Save your tears for another
+
+25
+00:02:19,300 --> 00:02:23,600
+I realize that I'm much too late
+
+26
+00:02:23,700 --> 00:02:26,800
+And you deserve someone better
+
+27
+00:02:26,900 --> 00:02:32,000
+Save your tears for another
+day (Ooh, yeah)
+
+28
+00:02:34,900 --> 00:02:40,900
+Save your tears for another day (Yeah)
+
+29
+00:02:46,100 --> 00:02:52,300
+I don't know why I run away
+
+30
+00:02:52,700 --> 00:02:57,400
+I'll make you cry when I run away
+
+31
+00:02:59,400 --> 00:03:06,650
+Save your tears for another
+day, ooh, girl (Ah)
+
+32
+00:03:06,700 --> 00:03:13,600
+I said save your tears
+for another day (Ah)
+
+33
+00:03:15,700 --> 00:03:23,200
+Save your tears for another day (Ah)
+
+34
+00:03:23,700 --> 00:03:33,300
+Save your tears for another day (Ah)
+
+35
+00:03:34,300 --> 00:03:43,300
+by DPSoftware Foundation