diff --git a/README.md b/README.md
index aa2c426c..6b4850da 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,42 @@
-# basicv2
+# BasicV2
 
-A Commodore BASIC V2 interpreter/compiler written in Java with some 6502 assembler on top.
+## Overview
 
-BasicV2 is an attempt to write a BASIC interpreter/compiler in Java that is compatible with the BASIC dialect that older 
-Commodore home computers like the C64 or VIC 20 were using. It can run BASIC programs written in BASIC V2 or ANSI BASIC.
-It doesn't use any parts of the implementation of the original Commodore BASIC like similar projects do. 
-It's a complete reimplementation in Java.
+BasicV2 is a Java-based interpreter and compiler for Commodore BASIC V2, the dialect used on systems like the C64 and VIC-20.
 
-It's basically two solutions in one. You can either compile the BASIC programs so that you can run them inside a Java environment/application using the runtime that the project provides.
-Or you can use the native cross compiler to compile it for the real C64, VIC20 or Commander X16 (not(!) Commodore 16) and run it on the actual machine or in an emulator. You'll find this compiler called MoSpeed as a command line application in the dist-directory (here: https://github.com/EgonOlsen71/basicv2/tree/master/dist ) of the project. It can be run on its own, you don't have to download/clone the whole project for this. There are also compile backends for Powershell, Javascript and Python included.
+It allows you to run and compile BASIC V2 and ANSI BASIC programs in a modern Java environment without relying on the original Commodore BASIC implementation. Instead, it is a complete reimplementation written in Java, with additional support for 6502 assembly.
 
-The native compiler is documented in this wiki as well: https://www.c64-wiki.com/wiki/MOSpeed
 
-There's also an online version available: https://jpct.de/mospeed
+## Features
 
-In addition, it offers a symbolic assembler that compiles assembly code into actual 6502 machine code. To execute these programs, it comes with a 6502 cpu emulation.
+- Compile and run BASIC V2 and ANSI BASIC programs in Java
+- Cross-compile programs for C64, VIC-20, and Commander X16 using MoSpeed
+- Includes a 6502 assembler and CPU emulator
+- No external Java dependencies (stand-alone project)
+- Can run programs via the command line or within Java applications
+- Includes basic HTML templating support
+- Includes GRAPHICS BASIC extension for enhanced graphics
+- Includes a BASIC shell/editor for writing and running programs (see `basicshell-package`)
+- Includes compile backends for PowerShell, JavaScript, and Python
 
-The sources come in a basic Maven project structure as an Eclipse project. It has no dependencies to any other Java libraries. It's a stand-alone thing.
 
-It can run BASIC programs from inside your application or from the command line. 
-You can even use it to process HTML-templates as it comes with a basic templating implementation.
+## Getting Started
 
-In addition to normal BASIC V2, it features a BASIC extension named GRAPHICS BASIC, which adds some commands for...graphics. The graphics capabilities aren't limited by some artifical C64 specs but take full advantage of a modern PC's capabilities.
+You can use BasicV2 in two main ways:
 
-Thanks to nietoperz809's efforts, there's a simple BASIC shell/editor available as well (see basicshell-package) that lets you load/save/edit/run BASIC programs in a C64-like editor. Or you can have a look at this second approach on this topic: https://github.com/nietoperz809/C64Screen
+- Run BASIC programs within a Java application using the provided runtime
+- Use the MoSpeed cross-compiler to compile programs for systems like the C64, VIC-20, or Commander X16 and run them on real hardware or in an emulator
 
-The native 6502 runtime code includes floating point optimizations based on Michael Jørgensen's work. See https://github.com/MJoergen
+The MoSpeed compiler is available as a command-line tool in the `dist` directory:
+https://github.com/EgonOlsen71/basicv2/tree/master/dist
 
+It can be used independently without cloning the full repository.
 
-There's a third party UI available for Windows and Linux: https://github.com/Error504TimeOut/MoSpeedUI/releases
+
+## Links and Resources
+
+- MoSpeed documentation: https://www.c64-wiki.com/wiki/MOSpeed
+- Online MoSpeed tool: https://jpct.de/mospeed
+- BASIC shell/editor project: https://github.com/nietoperz809/C64Screen
+- Floating point optimizations by Michael Jørgensen: https://github.com/MJoergen
+- Third-party UI (Windows/Linux): https://github.com/Error504TimeOut/MoSpeedUI/releases