https://github.com/krasimir/evala
Clock, Weather, Terminal ... евала :)
https://github.com/krasimir/evala
Last synced: 3 months ago
JSON representation
Clock, Weather, Terminal ... евала :)
- Host: GitHub
- URL: https://github.com/krasimir/evala
- Owner: krasimir
- License: mit
- Created: 2018-01-20T11:32:11.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-03-10T06:45:59.000Z (over 7 years ago)
- Last Synced: 2025-04-22T00:38:05.035Z (6 months ago)
- Language: CSS
- Homepage:
- Size: 14.4 MB
- Stars: 73
- Watchers: 5
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Evala
A web app that shows the time, the weather and brings your terminal in the browser. Ah ... and also changes its background color based on the temperature.
It is available as:
* [Chrome extension](https://chrome.google.com/webstore/detail/evala/bmaojegjknddmkhfbkhfijcblmamgino)
* [Firefox extension](https://addons.mozilla.org/en-US/firefox/addon/evala/)
* Web page at http://127.0.0.1:9788
## How to use it
### Install and run Evala server
The Evala server acts as a bridge between the browser and the actual terminal. Without it you'll only see the clock and the weather.
```
> npm install evala -g
> evala --shell=$SHELL
```
Make sure that you pass the `--shell` argument or Evala will use the default `bash` (or `cmd.exe` under Windows) shell.
You may register Evala server as a service so you get it running when you reboot your machine. What I did is registering an alias that allows me to run it quickly as a background process.
```
# Run Evala server with the default shell
# Save the output to a log file
# Run `evala` in a background
alias run-evala="evala --shell=$SHELL > ~/log/evala &"
```
### To see the app:
* Install this [Chrome](https://chrome.google.com/webstore/detail/evala/bmaojegjknddmkhfbkhfijcblmamgino) or [Firefox](https://addons.mozilla.org/en-US/firefox/addon/evala/) browser extension and open a new tab or
* Open [http://127.0.0.1:9788](http://127.0.0.1:9788).
### Terminal shortcuts
* `Ctrl` + `Shift` + `Alt` + `+` - Increase font size
* `Ctrl` + `Shift` + `Alt` + `-` - Decrease font size
* `Ctrl` + `Shift` + `Alt` + `v` - Split vertically
* `Ctrl` + `Shift` + `Alt` + `h` - Split horizontally
* `Ctrl` + `Shift` + `Alt` + `w` - Close terminal
### Using a custom forecast data provider
In the settings page you may set your own data provider for the forecast. The JSON should look like [this file](https://github.com/krasimir/evala/blob/master/build/mocks/weather.json). Not all the data is used in the app. What you need to provide is:
* `timezone`
* `city_name`
* `country_code`
* For the different days: `datetime`, `weather`, `icon`, `max_temp`, `min_temp` and `temp`
*More about the icons [here](https://github.com/krasimir/evala/blob/master/src/app/constants.js#L40)*
## Misc
* [Introductory blog post](http://krasimirtsonev.com/blog/article/meet-evala-your-terminal-in-the-browser-extension)