Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/warmachine028/better-calculator

Repository for Better Calculator
https://github.com/warmachine028/better-calculator

better-calculator calculator calculator-applications dark-theme gui minimalistic-theme python python-3 scientific-calculator tkinter tkinter-gui

Last synced: 2 months ago
JSON representation

Repository for Better Calculator

Host: GitHub
URL: https://github.com/warmachine028/better-calculator
Owner: warmachine028
License: bsd-3-clause
Created: 2020-12-18T16:36:00.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2021-09-20T11:16:35.000Z (over 3 years ago)
Last Synced: 2023-03-04T05:45:44.262Z (almost 2 years ago)
Topics: better-calculator, calculator, calculator-applications, dark-theme, gui, minimalistic-theme, python, python-3, scientific-calculator, tkinter, tkinter-gui
Language: Python
Homepage: https://warmachine028.github.io/Better-Calculator
Size: 10.4 MB
Stars: 5
Watchers: 2
Forks: 4
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

            updated: Monday, 13th September 2021



    

     Aesthetic outside Stronger inside 

     

    


      

    


    

    

    



# [Better Calculator](https://github.com/warmachine028/Better-Calculator)

## What's new?

- Added a new icon in README

- Addition of Clear History Feature

- Added 3 buttons to delete history

- Fixed Frames Overlap Scientific Frame

## Table of Contents

- [Introduction](#introduction)

- [Getting Started](#getting-started)

- [Usage](#usage)

- [How to](#how-to)

- [Customizations](#customizations)

- [Acknowledgement](#acknowledgement)

- [Previews](#previews)

- [Contributing](#contributing)

- [License](#License)

---

## Introduction

- This is my first Project in github.

- I'm trying to put all my dedication into it.

- It's a fully feature packed calculator.

- A completely new concept.

- Please contribute to it and show me how to imporve my github skills.

- Find issues and suggest changes.

---

## Getting Started

### Requirements

- [python 3.x] - Python 3 and above

- [PIL] for dealing with icons. If not installed

```sh

$ pip install pillow

```

### Clone this repository using the following command

- (nearly 20 MB)

```sh

$ git clone https://github.com/warmachine028/Better-Calculator

```

---

## Usage

1. Download the Latest Stable release from [releases].

2. Try the latest [BETA release].

3. Clone this Repo to contribute by following these [steps](#getting-started).

4. To customize your theme, see: [themes.json].

5. View [CHANGELOG] for detailed updates and issues.

6. Old versions archived in [versions] folder.

---

## How to

 1. Use AOT feature 

AOT: Always On Top feature 


Press the icon beside the label Calculator  


AOT ACTIVE: colour of the label changes and becomes italic  


AOT INACTIVE: colour of label reverts and becomes normal  



    



 2. Use Scientific Mode 

Press the = button below Entry widget to open scientific menu 


To activate inverse Trigonometric Functions press INV 


 NOTE: 

To use factorial function press ! first and then enter the input. 





 3. Use History Feature 

Press H button beside AOT button to view history. 


If log.txt is Empty the Labels will show: Not enough Data 


See the history of calculations in reverse order. 





 4. Set a Custom theme 

Open data/themes.json  


Rename Theme 1 / Theme 2 to the required themes 





## Customizations

- Common attributes

| Attribute               | Description                                            |

| ----------------------- | :----------------------------------------------------- |

| `_comment`              | Short description about the theme                      |

| `Theme name`            | The name of theme which appears in the application     |

| `Background Color`      | The background color of the application                |

| `Foreground Color`      | The text-color of left buttons                         |

| `AOT active Text Color` | The accent color of the app                            |

|                         | > Text color of right side buttons                     |

|                         | > Text color of label: AOT active                      |

| `Hover Color`           | The color when mouse pointer is hovering above buttons |

| `Radio Switch Color`    | The color of theme changer (circular button)           |

| `Radio Text Color`      | The color of the text of theme changer                 |

- Input Screen

| Attribute           | Description                       |

| ------------------- | :-------------------------------- |

| `Background Color`  | The background of input screen    |

| `Foreground Color`  | The text-color of input screen    |

| `Select Background` | The background of selected text   |

| `Select Foreground` | The text color of selected text   |

| `Cursor Color`      | The color of cursor in the screen |

- Scientific Colors

| Attribute             | Description                                              |

| --------------------- | :------------------------------------------------------- |

| `Background Color`    | The background of scientific buttons                     |

| `Foreground Color`    | The text-color of scientific buttons                     |

| `\|INV\| Color`       | The color of Inverse Button when active                  |

| `Hover Color`         | The color when mouse pointer is above scientific buttons |

| `Hover Color \|INV\|` | The color when mouse is above "activated" inverse button |

### Demo

![Customizations](images/custom.gif)

## Acknowledgement

- I took up this project as a lockdown hobby but later turned it into a serious project as I had to do something for my

  University Assignment.

- The pandemic was very boring and monotonic, so I thought of making something which is necessary and fulfils the

  following criterias :-

    1. Useful

    2. Easy to use

    3. Minimalistic UX design

    4. Uses some GUI framework

- Also, those days I couldn't find an appropriate calculator application online which suited my choice and designs.

- So I thought why not try to build one for myself and the community :)

## Previews

|               **Super Dark**               |            **Aurora Light**            |

| :----------------------------------------: | :------------------------------------: |

| ![dark](images/screen-calculator-dark.png) | ![light](images/screen-calculator.png) |

|             **Midnight City**              |            **COMMING SOON**            |

| ![midnight-city](images/midnight-city.jpg) |                                        |

## Contributing

### How To contribute to this Project ?

- Fork this project

- Clone the repository remotely

- Create a new branch

- Make changes

- Push to your forked repository

- Create [PULL-REQUEST] here

- see [CONTRIBUTING]

## License

- see [LICENSE]

**Pritam, 2021**

[license]: https://github.com/warmachine028/Better-Calculator/blob/main/LICENSE

[contributing]: https://github.com/warmachine028/Better-Calculator/blob/main/.github/CONTRIBUTING.md

[releases]: https://github.com/warmachine028/Better-Calculator/releases

[website]: "https://warmachine028.github.io/Better-Calculator/"

[python 3.x]: https://www.python.org/downloads/release/python-396/

[pil]: https://pypi.org/project/Pillow

[beta release]: https://github.com/warmachine028/Better-Calculator/releases/tag/V4.2.1-beta

[themes.json]: https://github.com/warmachine028/Better-Calculator/blob/main/data/themes.json

[changelog]: https://github.com/warmachine028/Better-Calculator/blob/main/.github/CHANGELOG.md

[versions]: https://github.com/warmachine028/Better-Calculator/blob/main/data/versions

[PULL-REQUEST]:https://github.com/warmachine028/Better-Calculator/blob/main/.github/PULL_REQUEST_TEMPLATE.md