github directory name changed
0
github/_apps.png → .github/_apps.png
vendored
Before Width: | Height: | Size: 90 KiB After Width: | Height: | Size: 90 KiB |
Before Width: | Height: | Size: 93 KiB After Width: | Height: | Size: 93 KiB |
0
github/_home.png → .github/_home.png
vendored
Before Width: | Height: | Size: 75 KiB After Width: | Height: | Size: 75 KiB |
0
github/_themes.png → .github/_themes.png
vendored
Before Width: | Height: | Size: 226 KiB After Width: | Height: | Size: 226 KiB |
43
README.md
@ -5,23 +5,26 @@
|
|||||||
[![Node Badge](https://img.shields.io/badge/Node.js-43853D?style=for-the-badge&logo=node.js&logoColor=white)](https://shields.io/)
|
[![Node Badge](https://img.shields.io/badge/Node.js-43853D?style=for-the-badge&logo=node.js&logoColor=white)](https://shields.io/)
|
||||||
[![React Badge](https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)](https://shields.io/)
|
[![React Badge](https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)](https://shields.io/)
|
||||||
|
|
||||||
![Homescreen screenshot](./github/_home.png)
|
![Homescreen screenshot](./.github/_home.png)
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
Flame is self-hosted startpage for your server. Its design is inspired (heavily) by [SUI](https://github.com/jeroenpardon/sui). Flame is very easy to setup and use. With built-in editors it allows you to setup your very own appliaction hub in no time - no file editing necessary.
|
Flame is self-hosted startpage for your server. Its design is inspired (heavily) by [SUI](https://github.com/jeroenpardon/sui). Flame is very easy to setup and use. With built-in editors it allows you to setup your very own appliaction hub in no time - no file editing necessary.
|
||||||
|
|
||||||
## Technology
|
## Technology
|
||||||
|
|
||||||
- Backend
|
- Backend
|
||||||
- Node.js + Express
|
- Node.js + Express
|
||||||
- Sequelize ORM + SQLite
|
- Sequelize ORM + SQLite
|
||||||
- Frontend
|
- Frontend
|
||||||
- React
|
- React
|
||||||
- Redux
|
- Redux
|
||||||
- TypeScript
|
- TypeScript
|
||||||
- Deployment
|
- Deployment
|
||||||
- Docker
|
- Docker
|
||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# clone repository
|
# clone repository
|
||||||
git clone https://github.com/pawelmalak/flame
|
git clone https://github.com/pawelmalak/flame
|
||||||
@ -34,13 +37,14 @@ npm run dev-init
|
|||||||
npm run dev
|
npm run dev
|
||||||
```
|
```
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
### With Docker (recommended)
|
### With Docker (recommended)
|
||||||
|
|
||||||
[Docker Hub](https://hub.docker.com/r/pawelmalak/flame)
|
[Docker Hub](https://hub.docker.com/r/pawelmalak/flame)
|
||||||
|
|
||||||
#### Building images
|
#### Building images
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# build image for amd64 only
|
# build image for amd64 only
|
||||||
docker build -t flame .
|
docker build -t flame .
|
||||||
@ -54,14 +58,16 @@ docker buildx build \
|
|||||||
```
|
```
|
||||||
|
|
||||||
#### Deployment
|
#### Deployment
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# run container
|
# run container
|
||||||
docker run -p 5005:5005 -v /path/to/data:/app/data flame
|
docker run -p 5005:5005 -v /path/to/data:/app/data flame
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Docker-Compose
|
#### Docker-Compose
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
version: "2.1"
|
version: '2.1'
|
||||||
services:
|
services:
|
||||||
flame:
|
flame:
|
||||||
image: pawelmalak/flame:latest
|
image: pawelmalak/flame:latest
|
||||||
@ -74,46 +80,54 @@ services:
|
|||||||
```
|
```
|
||||||
|
|
||||||
### Without Docker
|
### Without Docker
|
||||||
|
|
||||||
Follow instructions from wiki: [Installation without Docker](https://github.com/pawelmalak/flame/wiki/Installation-without-docker)
|
Follow instructions from wiki: [Installation without Docker](https://github.com/pawelmalak/flame/wiki/Installation-without-docker)
|
||||||
|
|
||||||
## Functionality
|
## Functionality
|
||||||
|
|
||||||
- Applications
|
- Applications
|
||||||
- Create, update, delete and organize applications using GUI
|
- Create, update, delete and organize applications using GUI
|
||||||
- Pin your favourite apps to homescreen
|
- Pin your favourite apps to homescreen
|
||||||
|
|
||||||
![Homescreen screenshot](./github/_apps.png)
|
![Homescreen screenshot](./.github/_apps.png)
|
||||||
|
|
||||||
- Bookmarks
|
- Bookmarks
|
||||||
- Create, update, delete and organize bookmarks and categories using GUI
|
- Create, update, delete and organize bookmarks and categories using GUI
|
||||||
- Pin your favourite categories to homescreen
|
- Pin your favourite categories to homescreen
|
||||||
|
|
||||||
![Homescreen screenshot](./github/_bookmarks.png)
|
![Homescreen screenshot](./.github/_bookmarks.png)
|
||||||
|
|
||||||
- Weather
|
- Weather
|
||||||
|
|
||||||
- Get current temperature, cloud coverage and weather status with animated icons
|
- Get current temperature, cloud coverage and weather status with animated icons
|
||||||
|
|
||||||
- Themes
|
- Themes
|
||||||
- Customize your page by choosing from 12 color themes
|
- Customize your page by choosing from 12 color themes
|
||||||
|
|
||||||
![Homescreen screenshot](./github/_themes.png)
|
![Homescreen screenshot](./.github/_themes.png)
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
### Search bar
|
### Search bar
|
||||||
|
|
||||||
#### Searching
|
#### Searching
|
||||||
|
|
||||||
To use search bar you need to type your search query with selected prefix. For example, to search for "what is docker" using google search you would type: `/g what is docker`.
|
To use search bar you need to type your search query with selected prefix. For example, to search for "what is docker" using google search you would type: `/g what is docker`.
|
||||||
|
|
||||||
> You can change where to open search results (same/new tab) in the settings
|
> You can change where to open search results (same/new tab) in the settings
|
||||||
|
|
||||||
#### Supported search engines
|
#### Supported search engines
|
||||||
|
|
||||||
| Name | Prefix | Search URL |
|
| Name | Prefix | Search URL |
|
||||||
|------------|--------|-------------------------------------|
|
| ---------- | ------ | ----------------------------------- |
|
||||||
| Disroot | /ds | http://search.disroot.org/search?q= |
|
| Disroot | /ds | http://search.disroot.org/search?q= |
|
||||||
| DuckDuckGo | /d | https://duckduckgo.com/?q= |
|
| DuckDuckGo | /d | https://duckduckgo.com/?q= |
|
||||||
| Google | /g | https://www.google.com/search?q= |
|
| Google | /g | https://www.google.com/search?q= |
|
||||||
|
|
||||||
#### Supported services
|
#### Supported services
|
||||||
|
|
||||||
| Name | Prefix | Search URL |
|
| Name | Prefix | Search URL |
|
||||||
|--------------------|--------|-----------------------------------------------|
|
| ------------------ | ------ | --------------------------------------------- |
|
||||||
| IMDb | /im | https://www.imdb.com/find?q= |
|
| IMDb | /im | https://www.imdb.com/find?q= |
|
||||||
| Reddit | /r | https://www.reddit.com/search?q= |
|
| Reddit | /r | https://www.reddit.com/search?q= |
|
||||||
| Spotify | /sp | https://open.spotify.com/search/ |
|
| Spotify | /sp | https://open.spotify.com/search/ |
|
||||||
@ -121,13 +135,16 @@ To use search bar you need to type your search query with selected prefix. For e
|
|||||||
| Youtube | /yt | https://www.youtube.com/results?search_query= |
|
| Youtube | /yt | https://www.youtube.com/results?search_query= |
|
||||||
|
|
||||||
### Setting up weather module
|
### Setting up weather module
|
||||||
|
|
||||||
1. Obtain API Key from [Weather API](https://www.weatherapi.com/pricing.aspx).
|
1. Obtain API Key from [Weather API](https://www.weatherapi.com/pricing.aspx).
|
||||||
> Free plan allows for 1M calls per month. Flame is making less then 3K API calls per month.
|
> Free plan allows for 1M calls per month. Flame is making less then 3K API calls per month.
|
||||||
2. Get lat/long for your location. You can get them from [latlong.net](https://www.latlong.net/convert-address-to-lat-long.html).
|
2. Get lat/long for your location. You can get them from [latlong.net](https://www.latlong.net/convert-address-to-lat-long.html).
|
||||||
3. Enter and save data. Weather widget will now update and should be visible on Home page.
|
3. Enter and save data. Weather widget will now update and should be visible on Home page.
|
||||||
|
|
||||||
### Supported URL formats for applications and bookmarks
|
### Supported URL formats for applications and bookmarks
|
||||||
|
|
||||||
#### Rules
|
#### Rules
|
||||||
|
|
||||||
- URL starts with `http://`
|
- URL starts with `http://`
|
||||||
- Format: `http://www.domain.com`, `http://domain.com`
|
- Format: `http://www.domain.com`, `http://domain.com`
|
||||||
- Redirect: `{dest}`
|
- Redirect: `{dest}`
|
||||||
@ -139,11 +156,13 @@ To use search bar you need to type your search query with selected prefix. For e
|
|||||||
- Redirect: `http://{dest}`
|
- Redirect: `http://{dest}`
|
||||||
|
|
||||||
### Custom CSS
|
### Custom CSS
|
||||||
|
|
||||||
> This is an experimental feature. Its behaviour might change in the future.
|
> This is an experimental feature. Its behaviour might change in the future.
|
||||||
>
|
>
|
||||||
Follow instructions from wiki: [Custom CSS](https://github.com/pawelmalak/flame/wiki/Custom-CSS)
|
> Follow instructions from wiki: [Custom CSS](https://github.com/pawelmalak/flame/wiki/Custom-CSS)
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
|
|
||||||
If you want to support development of Flame and my upcoming self-hosted and open source projects you can use the following link:
|
If you want to support development of Flame and my upcoming self-hosted and open source projects you can use the following link:
|
||||||
|
|
||||||
[![PayPal Badge](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://www.paypal.com/paypalme/pawelmalak)
|
[![PayPal Badge](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://www.paypal.com/paypalme/pawelmalak)
|
||||||
|