|
1 | | -# Meower-Server |
| 1 | + |
| 2 | +# Server |
2 | 3 | Official source code of the Meower server, written in Python. Powered by CloudLink. |
3 | 4 |
|
4 | | -## NOTICE |
5 | | -This is the APIv0 Branch of Code! This API code will only be maintained up until when New Meower is released. |
6 | | - |
7 | | -APIv0 will be upgraded automatically to APIv1 when Beta 6 is released. The API can be found at https://api.meower.org/ |
8 | | - |
9 | | -## Installing Dependencies |
10 | | -* Run `pip3 install -r requirements.txt` in the downloaded and unzipped directory |
11 | | - |
12 | | -## Running the server |
13 | | - |
| 5 | +## Running |
14 | 6 | ```py |
15 | | -git clone https://github.com/meower-media-co/Meower-Server.git --recursive |
| 7 | +git clone https://github.com/meower-media/server.git --recursive |
16 | 8 | cd Meower-Server |
17 | | -python3 main.py |
18 | | -``` |
19 | | - |
20 | | -To connect to the server, change the IP settings of your client to connect to ws://127.0.0.1:3000/. |
21 | | - |
22 | | -### Rest API |
23 | | - |
24 | | -This Rest API is configured to use CF Argo Tunnels for getting client IPs, but otherwise everything will function. |
25 | | - |
26 | | -Currently supported functions of the API: |
27 | | - |
28 | | -* /home - Gets the current homepage index. |
29 | | -* /home?page=# - Lets you get a certain page # of the homepage. |
30 | | -* /home?autoget - Automatically fetches all posts currently present on the page. |
31 | | -* /ip - Gets the client's IP address and returns with plaintext. Only works if the server is communicating with a client over CF Argo Tunnels. |
32 | | -* /posts?id=(Post ID) - Gets a Post ID, use /home to get an index of posts. |
33 | | -* /status - Status for the Meower Server. |
34 | | -* /posts/(Chat ID) - Gets the specified chat ID's index. |
35 | | -* /reports - Gets the reports index (only accessable if a moderator or higher. |
36 | | -* /inbox - Gets the specified user's inbox. |
37 | | -* /search/home?q=(Query) - Searches home. |
38 | | -* /search/users?q=(Query) - Searches users. |
39 | | -* /users/(Username) - Gets the specified user's info. |
40 | | -* /users/(Username)/posts - Gets the specified user's posts. |
41 | | -* /statistics - Shows Meower's statistics (users, posts, and chats) |
42 | | -### Trust keys and access control |
| 9 | +cd Meower-Server |
| 10 | +pip install -r requirements.txt |
43 | 11 |
|
44 | | -In development, Meower is configured to use "meower" as a CloudLink Trust key. If you notice a forked server using this key, please request for it to be removed. This key is intended for development purposes only. |
| 12 | +cp .env.example .env |
45 | 13 |
|
46 | | -Meower is configured to use CloudLink's Trusted Access feature, which implements the following security features: |
47 | | -1. IP blocker feature |
48 | | -2. Client kicking |
49 | | -3. Trust keys |
50 | | -4. Protection from maliciously modified clients |
| 14 | +# edit env files |
51 | 15 |
|
52 | | -## Contributing to the source |
| 16 | +python3 main.py |
| 17 | +``` |
53 | 18 |
|
54 | | -1. Make a fork of the repo |
55 | | -2. Modify your source |
56 | | -3. Open a PR |
| 19 | +## API docs |
| 20 | +See [the autogenerated documentation](https://api.meower.org/docs) and the [Meower documentation](https://docs.meower.org) |
0 commit comments