NerdCalci - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #llm #golang #deep-learning #linux #docker #nodejs #kubernetes #awesome-list #mcp #ios #open-source

NerdCalci

(★ 193)

Fully offline Android calculator app for power users with variable support, syntax highlighting, file-based sessions, and more.

File Explorer

Download Latest Version (.zip)

- - bug_report.yml
  - config.yml
  - feature_request.yml
  - improvement.yml
- - build.yml
  - release.yml
- FUNDING.yml
- - Project_Default.xml
- .gitignore
- build.gradle.kts
- proguard-rules.pro
- geometry.nerdcalci
- README.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
- com.vishaltelangre.nerdcalci.yml
.gitignore
AGENTS.md
build.gradle.kts
CHANGELOG.md
gradle.properties
gradlew
gradlew.bat
LICENSE
PRIVACY.md
README.md
REFERENCE.md
RELEASE.md
settings.gradle.kts
TERMS.md

# Installation Guide

1. Get the code

git clone https://github.com/vishaltelangre/NerdCalci

Downloads the entire project code from GitHub to your computer.

cd NerdCalci

Moves into the project folder you just downloaded.

2. Gradle (Java/Kotlin)

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java/Kotlin projects.
Gradle If the repo includes gradlew (Gradle Wrapper), you don't need to install Gradle separately.

./gradlew :app:testDebugUnitTest

Builds the project using Gradle.

./gradlew :app:testDebugUnitTest --tests "com.vishaltelangre.nerdcalci.core.MathEngineTest"

Builds the project using Gradle.

./gradlew :app:connectedDebugAndroidTest

Builds the project using Gradle.

✅ A BUILD SUCCESSFUL message means it worked. The output is created under build/.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">NerdCalci</h1>

<p align="center">
  <img align="center" src="app/src/main/res/mipmap-xxxhdpi/ic_launcher.png" alt="NerdCalci Icon" width="192" height="192">
</p>

<p align="center">
  <strong>Fully offline Android calculator app for power users with variable support, syntax highlighting, file-based sessions, and more. A free Android alternative to proprietary text-based calculators like Numi, Calca, and Soulver.</strong>
</p>

[<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png"
    alt="Get it on Google Play"
    height="80">](https://play.google.com/store/apps/details?id=com.vishaltelangre.nerdcalci)
[<img src="https://f-droid.org/badge/get-it-on.png"
    alt="Get it on F-Droid"
    height="80">](https://f-droid.org/packages/com.vishaltelangre.nerdcalci/)
[<img
src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png"
height="80" alt="Get it at
IzzyOnDroid">](https://apt.izzysoft.de/packages/com.vishaltelangre.nerdcalci)
[<img src="https://github.com/user-attachments/assets/713d71c5-3dec-4ec4-a3f2-8d28d025a9c6"
    alt="Get it on Obtainium" height="80">](https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7B%22id%22%3A%22com.vishaltelangre.nerdcalci%22%2C%22url%22%3A%22https%3A%2F%2Fgithub.com%2Fvishaltelangre%2FNerdCalci%22%2C%22author%22%3A%22vishaltelangre%22%2C%22name%22%3A%22NerdCalci%22%2C%22supportFixedAPKURL%22%3Afalse%7D)
[<img src="https://github.com/machiav3lli/oandbackupx/raw/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png"
    alt="Get it on GitHub"
    height="80">](https://github.com/vishaltelangre/NerdCalci/releases)

## Screenshots

<p align="center">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" alt="Screenshot 1" width="300">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" alt="Screenshot 2" width="300">
</p>
<p align="center">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" alt="Screenshot 3" width="300">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" alt="Screenshot 4" width="300">
</p>
<p align="center">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/6.png" alt="Screenshot 5" width="300">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/7.png" alt="Screenshot 6" width="300">
</p>

## Features

### Smart calculations

> [!NOTE]
> All supported operators, functions, and advanced syntax is extensively explained and documented in the [reference guide](REFERENCE.md).

- #### Variable support

```text
  a = 100
  b = 200
  total = a + b  # 300
  ```

- #### Composite operations

```text
  score = 10
  score += 5     # 15
  score++        # 16
  score /= 4     # 4
  ```

- #### Percentage calculations

```text
  20% of 50000    # 10000
  15% off 1000    # 850
  50000 + 10%     # 55000
  50000 - 5%      # 47500
  ```

- #### Dynamic variables

```text
  groceries = 45.50
  utilities = 120
  rent = 950
  total           # 1115.50

feb = 200
  mar = 300
  avg             # 250
  ```

- #### Unit conversions & arithmetic

```text
  10km + 500m    # 10500 m
  5 kg to g      # 5000 g
  100 °C as °F    # 212 °F
  ```

- #### Numeral systems

```text
  5 million       # 5000000
  1.5 crore       # 15000000
  ```

- #### Comments

```text
  price = 1000  # base price
  tax = 18% of price  # 180
  ```

- #### Calendar-aware date & time calculations

```text
  today + 3 weeks
  now - 4 hours 30 mins
  3 days ago
  2 days from now

# Intervals
  days between today and date(2025, 1, 1)
  today through tomorrow in hours

# Timezones
  now in "Japan"
  datetimeZ(2024, 1, 1, 12, 0, 0, "UTC") in "Tokyo"

today as iso8601
  now as timestamp
  ```

- #### User-defined functions

```text
  sq(x) = x ^ 2
  sq(5)          # 25

# Support for multi-statement bodies
  salary(hours) = base = hours * 50; bonus = base * 0.1; base + bonus
  salary(160)    # 8800
  ```

- #### Cross-file references

```text
  f = file("Summary")
  total_cost = f.total * 1.1

# Or invoke functions directly
  file("Calculations").taxFunc(1000)
  ```

- #### Mathematical functions

```text
  sqrt(16)           # 4
  sin(PI/2)          # 1
  sin(45)            # 0.85 (radians by default)
  sin(45°)           # 0.7071 (supports degrees)
  ```

### Editor features
- **Syntax highlighting**: Color-coded variables, numbers, operators, and comments
- **Smart error diagnostics**: See human-friendly explanation of math or syntax errors
- **Auto-completion**: Smart variable suggestions as you type
- **Line numbers**: Easy reference and navigation

### File management
- **Multiple files**: Create and manage separate calculation files
- **Tags**: Organize files with custom tags
- **Auto-save**: Changes are saved automatically
- **Pin files**: Keep important files at the top (max 10 pinned files)
- **Search**: Search files easily by name or tag
- **Duplicate files**: Create a copy of a file with a new name
- **Backups**: Automatically or manually backup your files to app storage or a custom folder
- **Restore from backups**: Restore your files safely with support for conflict resolution (Keep local, replace, or keep both)
- **Copy with results**: Copy file content with calculated results to clipboard
- **Export**: Share your calculations as a PNG image or a multi-page PDF

### And more...
- **Offline**: Works without internet
- **Undo/Redo**: Up to 30 steps per file
- **Dark/light theme**: System, dark, or light mode
- **Real-time results**: See calculations update as you type

## Built with

- [**Kotlin**](https://kotlinlang.org/) - Primary programming language
- [**Jetpack Compose**](https://developer.android.com/compose) - Modern UI toolkit
- [**Room Database**](https://developer.android.com/training/data-storage/room) - Local data persistence
- [**Material Design 3**](https://developer.android.com/jetpack/androidx/releases/compose-material3) - UI components and theming
- [**Fira Code**](https://github.com/tonsky/FiraCode) - Monospace font with ligatures

## Inspiration

A heartfelt thank you to the brilliant creators behind these incredible text-based calculators that inspired the creation of NerdCalci:

- [**Numi**](https://numi.app/)
- [**Calca**](https://calca.io/)
- [**Soulver**](https://soulver.app/)

## Development

### Running tests

Run all unit tests:

```bash
./gradlew :app:testDebugUnitTest
```

Run specific test class:
```bash
./gradlew :app:testDebugUnitTest --tests "com.vishaltelangre.nerdcalci.core.MathEngineTest"
```

After running tests, view the HTML report:

```bash
open app/build/reports/tests/testDebugUnitTest/index.html
```

To run instrumentation tests:

```bash
./gradlew :app:connectedDebugAndroidTest
```

## Community calci submissions

The [`community-submissions/`](community-submissions/) directory is a curated
collection of NerdCalci files ("**calcis**") shared by the community. Each
calci is a plain-text `.nerdcalci` file that showcases reusable calculations,
domain-specific helpers, or handy formulas.

Refer to [community submissions guidelines](community-submissions/README.md) for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## License

This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.