Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
shakg authored Sep 25, 2023
1 parent 92aa3f8 commit a1a8051
Showing 1 changed file with 88 additions and 2 deletions.
90 changes: 88 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,89 @@
# g-systemctl
graphical systemctl to manage services
# G-Systemctl

g-systemctl is a graphical user interface for your services in *nix systems. you can see all of your service deamons and search, filter them.

## Table of Contents

- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [API](#api)
- [Frontend](#frontend)
- [Contributing](#contributing)

### Prerequisites

- Go (Golang): [Install Go](https://golang.org/doc/install)
- A web browser for frontend testing

### Installation

1. Clone the repository:

```bash
git clone https://github.com/yourusername/your-repo.git
cd your-repo
```

2. Build the project:

```bash
go build server.go
```

## Usage

```bash
sudo chmod +x server
```
and

```bash
./server <port>
```
<port> could be any free port in your system. For example 8080.

### Running the Server

To start the server, run the executable or use `go run` with the following command:

```bash
./server <port>
# or
go run server.go <port>
```

Replace `<port>` with the desired port number (e.g., 8080).

The server will be accessible at `http://localhost:<port>`.

## API

The API provides information about the running system's status.

- **Endpoint:** `/api`
- **Method:** `GET`

Example response:

> TODO : Change this to correct output.
```json
{
"service_1": "active",
"service_2": "inactive",
...
}
```

## Frontend

The frontend of this project consists of vanilla HTML and JavaScript. The frontend files are served at the root path ("/").

- **HTML File:** `index.html`
- **JavaScript File:** `app.js`

You can access the frontend at `http://localhost:<port>`.

## Contributing

Contributions are welcome! Please follow the [Contributing Guidelines](CONTRIBUTING.md) for details on how to contribute to this project.

0 comments on commit a1a8051

Please sign in to comment.