[FEAT] readme+err handling+dragdrop setup

Author: nots1dd

README.md

@@ -1,72 +1,124 @@
-# rAVen 
+# rAVen
 
 > [!NOTE]
-> 
-> rAVen is currently a WIP
-> 
+> rAVen is currently a **Work in Progress (WIP)**.
 
-Just making songs look cool
+### Just making AUDIO look and feel cool
 
-## Deps
+---
 
-clang (or any C compiler really)
+## Table of Contents
+1. [Dependencies](#deps)
+2. [C Libraries Used](#c-libs-used)
+3. [Understanding FFT](#understanding-fft)
+4. [Building rAVen](#building)
+   - [Using Build Script](#using-build-script)
+   - [Using Makefile](#using-makefile)
+   - [Using CMake](#using-cmake)
+5. [FAQ](#faq)
+6. [License](#license)
 
-bash
+---
 
-## C libs used
+## <a id="deps"></a>Deps
 
--> raylib
+- **Clang / GCC**
+- **Bash**
+- [C libs](#c-libs-used)
 
--> math, complex, assert for FFT
+---
 
--> libavformat for metadata extraction
+## <a id="c-libs-used"></a>C Libraries Used
 
-Other standard libs
+- **raylib**: For rendering and visualizing audio
+- **math, complex, assert**: For FFT (Fast Fourier Transform)
+- **libavformat**: For metadata extraction
+- Other standard C libraries
 
-## UNDERSTANDING FFT
+---
 
-Fast Fourier Transform is very cool and blends both maths and algorithms pretty well
+## <a id="understanding-fft"></a>Understanding FFT
 
-Check the comments in the [FFT](https://github.com/nots1dd/rAVen/blob/main/fft.c) C file
+Fast Fourier Transform (FFT) is a powerful algorithm that blends math and algorithms beautifully.
 
-## Building
+To dive deeper, check out the comments in the [FFT.c](https://github.com/nots1dd/rAVen/blob/main/fft.c) file to understand how FFT is used to analyze audio samples.
+
+---
+
+## <a id="building"></a>Building rAVen
 
 > [!WARNING]
-> 
-> Build Script is not available right now
-> 
-> It is going under some changes
-> 
-> Use Makefile instead
-> 
-
-Using the build script:
-
-```sh 
-chmod +x build.sh 
+> The build script is currently unavailable as it's undergoing changes.
+> For now, use the **Makefile**.
+
+### <a id="using-build-script"></a>Using the Build Script:
+```bash
+chmod +x build.sh
 ./build.sh
-./raven
+./raven samples/sample-15s.wav
 ```
 
-Using Makefile:
-
-```sh
+### <a id="using-makefile"></a>Using Makefile:
+```bash
 make
 ./raven
 ```
 
-Using CMake:
-
-```sh 
+### <a id="using-cmake"></a>Using CMake:
+```bash
 cmake -S . -B build/
-cmake --build build/ 
-./build/raven 
+cmake --build build/
+./build/raven samples/sample-15s.wav
 ```
 
+---
+
+## <a id="faq"></a>FAQ
+
+### 1. How does the math work?
+
+Check out the [fft.c](https://github.com/nots1dd/raven/blob/main/fft.c) file to understand how **Fast Fourier Transform** is used to analyze audio samples.
+
+---
+
+### 2. What audio formats are supported?
+
+rAVen supports all formats supported by [RAYLIB](https://github.com/raysan5/raylib). 
+
+> [!NOTE]
+> Although RAYLIB supports `.flac`, it's **not enabled by default**. To enable `.flac` support:
+>
+> - Go to `src/config.h` in raylib and uncomment the following line:
+>   ```c
+>   //#define SUPPORT_FILEFORMAT_FLAC 1
+>   ```
+> Then follow the raylib documentation for building raylib with this change.
+
+### 3. What color pallette does rAVen follow?
+
+rAVen uses [GRUVBOX](https://github.com/morhetz/gruvbox) color schema
+This color schema is something I use daily and I have come to really like it 
+
+There may be a time in the future of rAVen where I may make the theme **customizable** but for now, hope you like GRUVBOX :)
+
+---
+
+### 3. Will rAVen integrate with audio services like PipeWire, ALSA, or PulseAudio?
+
+rAVen aims to support these services eventually. The first priority will be **PipeWire**, with plans to explore **ALSA** and **PulseAudio** integration in the future.
+
+---
+
+## <a id="license"></a>License
+
+rAVen is free and open-source software, licensed under the **GNU Lesser General Public License**. See the full [LICENSE](https://github.com/nots1dd/raven/blob/main/LICENSE) for more details.
+
+---
+
+### Screenshots
+
 ![raven1](https://github.com/user-attachments/assets/40ab07df-4f43-406d-b30f-77b133780d12)
 ![raven2](https://github.com/user-attachments/assets/3aa6de17-62b4-4f64-9b35-31ec6d0fbb5b)
 ![raven3](https://github.com/user-attachments/assets/51a291b7-12d6-41b1-af3d-52759791a093)
 
-
-
-rAVen is free and open source software licensed under GNU Lesser General Public License [LICENSE](https://github.com/nots1dd/raven/blob/main/LICENSE)
+---

main.c

@@ -38,11 +38,11 @@
 #define GRUVBOX_PURPLE \
   (Color) { 211, 134, 155, 255 } // #d3869b
 
-typedef struct
-{
-  float left;
-  float right;
-} Frame;
+/*typedef struct*/
+/*{*/
+/*  float left;*/
+/*  float right;*/
+/*} Frame;*/
 
 typedef enum
 {
@@ -67,7 +67,7 @@ typedef struct
  ********************************************************/
 
 float             freqs[N];
-Frame             global_frames[4800] = {0};
+float             global_frames[4800] = {0};
 size_t            global_frames_count = 0;
 float             in[N];
 float complex     out[N];
@@ -170,12 +170,12 @@ void SwitchVisualizationModeBackward() { currentMode = (currentMode - 1) % NUM_M
 void callback(void* bufferData, unsigned int frames)
 {
 
-  Frame* fs = bufferData;
+  float (*fs)[2] = bufferData;
 
   for (size_t i = 0; i < frames; i++)
   {
     memmove(in, in + 1, (N - 1) * sizeof(in[0]));
-    in[N - 1] = fs[i].left;
+    in[N - 1] = (fs[i][0]+fs[i][1])/2;
   }
 
   fft(in, 1, out, N);
@@ -651,6 +651,24 @@ int main(int argc, char* argv[])
       break;
     }
 
+    if (IsFileDropped()) {
+      PauseMusicStream(music);
+      FilePathList droppedFiles = LoadDroppedFiles();
+      printf("File dropped\n");
+      if (droppedFiles.count > 0) {
+        const char *file_path = droppedFiles.paths[0];
+        printf("%s", droppedFiles.paths[0]);
+        StopMusicStream(music);
+        UnloadMusicStream(music);
+        music = LoadMusicStream(file_path);
+        PlayMusicStream(music);
+        SetMusicVolume(music, currentVolume);
+        extract_metadata(file_path, &metadata);
+        AttachAudioStreamProcessor(music.stream, callback);
+      }
+      UnloadDroppedFiles(droppedFiles);
+    }
+
     // Detect if the user clicks on the info button
     if (IsMouseButtonPressed(MOUSE_LEFT_BUTTON) && IsMouseOverRectangle(infoButton))
     {
@@ -662,11 +680,17 @@ int main(int argc, char* argv[])
     {
       PauseMusicStream(music);
       OpenFileDialog();
-      UnloadMusicStream(music);
-      music = LoadMusicStream(selected_song);
-      PlayMusicStream(music);
-      extract_metadata(selected_song, &metadata);
-      AttachAudioStreamProcessor(music.stream, callback);
+      if (is_song_file(selected_song)) {
+        UnloadMusicStream(music);
+        music = LoadMusicStream(selected_song);
+        PlayMusicStream(music);
+        SetMusicVolume(music, currentVolume);
+        extract_metadata(selected_song, &metadata);
+        AttachAudioStreamProcessor(music.stream, callback);
+      } else {
+        printf("NOT A VALID SONG FILE\n");
+        ResumeMusicStream(music);
+      }
     }
     if (IsMouseButtonPressed(MOUSE_LEFT_BUTTON) && IsMouseOverRectangle(helpButton))
     {
@@ -751,9 +775,9 @@ int main(int argc, char* argv[])
     handleVisualization(cell_width, screenHeight, screenWidth, m);
 
     // Draw song title
-    const char* songTitle = "rAVen";
-    Vector2     titleSize = MeasureTextEx(font, songTitle, 40, 2);
-    DrawTextEx(font, songTitle, (Vector2){screenWidth / 2 - titleSize.x / 2, 20}, 40, 2,
+    const char* mainTitle = "rAVen";
+    Vector2     titleSize = MeasureTextEx(font, mainTitle, 40, 2);
+    DrawTextEx(font, mainTitle, (Vector2){screenWidth / 2 - titleSize.x / 2, 20}, 40, 2,
                GRUVBOX_BLUE);
 
     // Draw song details