Rename project from File-Broadcaster to filecast

Author: gistrec

.github/workflows/release.yml

@@ -12,14 +12,14 @@ jobs:
       matrix:
         include:
           - os: ubuntu-latest
-            artifact_name: FileBroadcaster
-            asset_name: FileBroadcaster-linux-x86_64
+            artifact_name: filecast
+            asset_name: filecast-linux-x86_64
           - os: macos-latest
-            artifact_name: FileBroadcaster
-            asset_name: FileBroadcaster-macos-arm64
+            artifact_name: filecast
+            asset_name: filecast-macos-arm64
           - os: windows-latest
-            artifact_name: FileBroadcaster.exe
-            asset_name: FileBroadcaster-windows-x86_64.exe
+            artifact_name: filecast.exe
+            asset_name: filecast-windows-x86_64.exe
 
     defaults:
       run:
@@ -45,13 +45,13 @@ jobs:
             cmake -S . -B build -G Ninja \
                   -DCMAKE_BUILD_TYPE=Release \
                   -DBUILD_TESTING=OFF \
-                  -DFILEBROADCASTER_VERSION="${VERSION}" \
+                  -DFILECAST_VERSION="${VERSION}" \
                   -DCMAKE_EXE_LINKER_FLAGS="-static -static-libgcc -static-libstdc++"
           else
             cmake -S . -B build \
                   -DCMAKE_BUILD_TYPE=Release \
                   -DBUILD_TESTING=OFF \
-                  -DFILEBROADCASTER_VERSION="${VERSION}"
+                  -DFILECAST_VERSION="${VERSION}"
           fi
 
       - name: Build

.gitignore

@@ -32,7 +32,7 @@
 *.app
 
 # Project binaries
-/FileBroadcaster
+/filecast
 /GTests
 
 # Debug symbols

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.15)
-project(FileBroadcaster CXX)
+project(filecast CXX)
 
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
@@ -10,37 +10,37 @@ if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
 endif()
 
 # Version string baked into the binary; the release workflow overrides this
-# from the git tag (e.g. -DFILEBROADCASTER_VERSION=v1.0.0).
-set(FILEBROADCASTER_VERSION "1.0.0" CACHE STRING "Version string for --version output")
+# from the git tag (e.g. -DFILECAST_VERSION=v1.0.0).
+set(FILECAST_VERSION "1.0.0" CACHE STRING "Version string for --version output")
 
 # --- main executable ---------------------------------------------------------
 
-add_executable(FileBroadcaster
+add_executable(filecast
     src/Main.cpp
     src/Sender.cpp
     src/Receiver.cpp
     src/Config.cpp
 )
 
-target_include_directories(FileBroadcaster PRIVATE
+target_include_directories(filecast PRIVATE
     ${CMAKE_CURRENT_SOURCE_DIR}/lib/cxxopts/include
 )
 
-target_compile_definitions(FileBroadcaster PRIVATE
-    FILEBROADCASTER_VERSION="${FILEBROADCASTER_VERSION}"
+target_compile_definitions(filecast PRIVATE
+    FILECAST_VERSION="${FILECAST_VERSION}"
 )
 
 if(MSVC)
-    target_compile_options(FileBroadcaster PRIVATE /W4 /permissive-)
+    target_compile_options(filecast PRIVATE /W4 /permissive-)
 else()
-    target_compile_options(FileBroadcaster PRIVATE -Wall -Wextra)
+    target_compile_options(filecast PRIVATE -Wall -Wextra)
 endif()
 
 if(WIN32)
-    target_link_libraries(FileBroadcaster PRIVATE ws2_32)
+    target_link_libraries(filecast PRIVATE ws2_32)
 else()
     find_package(Threads REQUIRED)
-    target_link_libraries(FileBroadcaster PRIVATE Threads::Threads)
+    target_link_libraries(filecast PRIVATE Threads::Threads)
 endif()
 
 # --- tests -------------------------------------------------------------------
@@ -70,7 +70,7 @@ if(BUILD_TESTING)
             COMMAND bash ${CMAKE_CURRENT_SOURCE_DIR}/tests/e2e.sh
         )
         set_tests_properties(e2e PROPERTIES
-            ENVIRONMENT "BINARY=$<TARGET_FILE:FileBroadcaster>"
+            ENVIRONMENT "BINARY=$<TARGET_FILE:filecast>"
         )
 
         # Lossy variant: a Python UDP proxy drops packets in both directions to
@@ -82,7 +82,7 @@ if(BUILD_TESTING)
                 COMMAND bash ${CMAKE_CURRENT_SOURCE_DIR}/tests/e2e_lossy.sh
             )
             set_tests_properties(e2e_lossy PROPERTIES
-                ENVIRONMENT "BINARY=$<TARGET_FILE:FileBroadcaster>;PYTHON=${Python3_EXECUTABLE}"
+                ENVIRONMENT "BINARY=$<TARGET_FILE:filecast>;PYTHON=${Python3_EXECUTABLE}"
                 TIMEOUT 120
             )
         else()

README.md

@@ -1,16 +1,16 @@
-# File-Broadcaster
+# Filecast
 
 <p align="left">
-    <a href="https://github.com/gistrec/File-Broadcaster/actions/workflows/tests.yml">
-        <img src="https://github.com/gistrec/File-Broadcaster/actions/workflows/tests.yml/badge.svg" alt="Tests"></a>
+    <a href="https://github.com/gistrec/filecast/actions/workflows/tests.yml">
+        <img src="https://github.com/gistrec/filecast/actions/workflows/tests.yml/badge.svg" alt="Tests"></a>
     <a>
       <img src="https://img.shields.io/codacy/grade/4c8169bcab3a4df18baad4e5658ec8ce" alt="Code quality"></a>
-    <a href="https://github.com/gistrec/File-Broadcaster/releases">
-        <img src="https://img.shields.io/github/v/release/gistrec/File-Broadcaster" alt="Release"></a>
+    <a href="https://github.com/gistrec/filecast/releases">
+        <img src="https://img.shields.io/github/v/release/gistrec/filecast" alt="Release"></a>
     <a>
       <img src="https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-brightgreen" alt="Platform"></a>
-    <a href="https://github.com/gistrec/File-Broadcaster/blob/master/LICENSE">
-        <img src="https://img.shields.io/github/license/gistrec/File-Broadcaster?color=brightgreen" alt="License"></a>
+    <a href="https://github.com/gistrec/filecast/blob/master/LICENSE">
+        <img src="https://img.shields.io/github/license/gistrec/filecast?color=brightgreen" alt="License"></a>
 </p>
 
 UDP broadcast file transfer — sends a single file to every host on the same
@@ -40,31 +40,31 @@ LAN at once, with automatic retransmission of dropped packets.
 ## Quick Start
 
 Download the binary for your platform from the
-[releases page](https://github.com/gistrec/File-Broadcaster/releases) and run
-it directly. No installation required.
+[releases page](https://github.com/gistrec/filecast/releases) and run it
+directly. No installation required.
 
 **Sender** (host that has the file):
 
 ```sh
-./FileBroadcaster --type sender --file photo.jpg
+./filecast --type sender --file photo.jpg
 ```
 
 **Receiver** (one or more hosts on the same LAN):
 
 ```sh
-./FileBroadcaster --type receiver --file photo.jpg
+./filecast --type receiver --file photo.jpg
 ```
 
 Send to a specific host instead of broadcasting to the whole LAN:
 
 ```sh
-./FileBroadcaster --type sender --file photo.jpg --broadcast 192.168.1.50
+./filecast --type sender --file photo.jpg --broadcast 192.168.1.50
 ```
 
 ## Installation
 
 Pre-built binaries for Linux x86_64, macOS arm64, and Windows x86_64 are
-attached to every [GitHub Release](https://github.com/gistrec/File-Broadcaster/releases).
+attached to every [GitHub Release](https://github.com/gistrec/filecast/releases).
 
 If your platform isn't covered, see [Building from Source](#building-from-source).
 
@@ -89,33 +89,33 @@ If your platform isn't covered, see [Building from Source](#building-from-source
 
 ```sh
 # On the sender host
-./FileBroadcaster --type sender --file album.zip
+./filecast --type sender --file album.zip
 
 # On every receiver host
-./FileBroadcaster --type receiver --file album.zip
+./filecast --type receiver --file album.zip
 ```
 
 **Targeted unicast** (when broadcast is blocked or you only have one receiver):
 
 ```sh
 # On the sender host (sends data to 10.0.0.42)
-./FileBroadcaster --type sender --file album.zip --broadcast 10.0.0.42
+./filecast --type sender --file album.zip --broadcast 10.0.0.42
 
 # On 10.0.0.42 (receiver default --broadcast=yes broadcasts RESENDs)
-./FileBroadcaster --type receiver --file album.zip
+./filecast --type receiver --file album.zip
 ```
 
 **Loopback test** (sender and receiver on the same host — useful for
 development):
 
 ```sh
 # Receiver listens on 33401, sends RESEND back to the sender's bind port (33402)
-./FileBroadcaster --type receiver --file out.bin \
-                  --broadcast 127.0.0.1 --port 33402 --bind-port 33401 &
+./filecast --type receiver --file out.bin \
+           --broadcast 127.0.0.1 --port 33402 --bind-port 33401 &
 
 # Sender listens on 33402, sends data to the receiver's bind port (33401)
-./FileBroadcaster --type sender --file in.bin \
-                  --broadcast 127.0.0.1 --port 33401 --bind-port 33402
+./filecast --type sender --file in.bin \
+           --broadcast 127.0.0.1 --port 33401 --bind-port 33402
 ```
 
 ## How It Works
@@ -160,26 +160,26 @@ development):
 ### Build
 
 ```sh
-git clone https://github.com/gistrec/File-Broadcaster.git
-cd File-Broadcaster
+git clone https://github.com/gistrec/filecast.git
+cd filecast
 git submodule update --init --recursive
 cmake -S . -B build
 cmake --build build --config Release
 ```
 
-The binary lands at `build/FileBroadcaster` (or
-`build\Release\FileBroadcaster.exe` with the multi-config Visual Studio
-generator).
+The binary lands at `build/filecast` (or `build\Release\filecast.exe` with the
+multi-config Visual Studio generator).
 
 ### Tests
 
 ```sh
 ctest --test-dir build --output-on-failure
 ```
 
-Runs the unit tests (requires Google Test installed) and the loopback
-end-to-end test. Pass `-E e2e` to skip the e2e case on Windows, where
-Winsock semantics break two-process loopback.
+Runs the unit tests, the loopback end-to-end test, and a lossy variant that
+drops packets through a Python UDP proxy to exercise the RESEND branch. Pass
+`-E e2e` to skip the e2e cases on Windows, where Winsock semantics break
+two-process loopback.
 
 ## License
 

src/Config.hpp

@@ -1,5 +1,5 @@
-#ifndef FILEBROADCASTER_CONFIG_H
-#define FILEBROADCASTER_CONFIG_H
+#ifndef FILECAST_CONFIG_H
+#define FILECAST_CONFIG_H
 
 #include "Utils.hpp"
 
@@ -28,4 +28,4 @@ extern size_t file_length; // File size in bytes
 extern char*  file;        // Pointer to file in RAM
 extern char*  buffer;      // Pointer to buffer
 
-#endif //FILEBROADCASTER_CONFIG_H
+#endif //FILECAST_CONFIG_H

src/Main.cpp

@@ -5,8 +5,8 @@
 #include <string>
 #include <cstdlib>
 
-#ifndef FILEBROADCASTER_VERSION
-#define FILEBROADCASTER_VERSION "1.0.0"
+#ifndef FILECAST_VERSION
+#define FILECAST_VERSION "1.0.0"
 #endif
 
 namespace Receiver { void run(); }
@@ -24,7 +24,7 @@ static void cleanupAndExit(int code) {
 
 int main(int argc, char* argv[]) {
     // Parsing input parameters from the CLI
-    cxxopts::Options options("File-Broadcaster", "UDP Broadcast file transfer");
+    cxxopts::Options options("filecast", "UDP broadcast file transfer over LAN");
 
     options
         .positional_help("[optional args]")
@@ -56,7 +56,7 @@ int main(int argc, char* argv[]) {
         return 0;
     }
     if (result.count("version")) {
-        std::cout << "File-Broadcaster " << FILEBROADCASTER_VERSION << std::endl;
+        std::cout << "filecast " << FILECAST_VERSION << std::endl;
         return 0;
     }
 

src/Utils.hpp

@@ -1,5 +1,5 @@
-#ifndef FILEBROADCASTER_UTILS_H
-#define FILEBROADCASTER_UTILS_H
+#ifndef FILECAST_UTILS_H
+#define FILECAST_UTILS_H
 
 #if defined(_WIN32) || defined(_WIN64)
 #define _WINSOCK_DEPRECATED_NO_WARNINGS
@@ -47,4 +47,4 @@ namespace Utils {
     }
 }
 
-#endif //FILEBROADCASTER_UTILS_H
+#endif //FILECAST_UTILS_H

tests/e2e.sh

@@ -7,11 +7,11 @@
 #
 # Or directly:
 #
-#   BINARY=build/FileBroadcaster bash tests/e2e.sh
+#   BINARY=build/filecast bash tests/e2e.sh
 #
 set -euo pipefail
 
-BINARY="${BINARY:-./FileBroadcaster}"
+BINARY="${BINARY:-./filecast}"
 
 if [ ! -x "$BINARY" ]; then
     echo "Error: $BINARY not found or not executable. Run 'make program' first." >&2

tests/e2e_lossy.sh

@@ -8,11 +8,11 @@
 #   ctest --test-dir build --output-on-failure
 #
 # Or directly:
-#   BINARY=build/FileBroadcaster bash tests/e2e_lossy.sh
+#   BINARY=build/filecast bash tests/e2e_lossy.sh
 #
 set -euo pipefail
 
-BINARY="${BINARY:-./FileBroadcaster}"
+BINARY="${BINARY:-./filecast}"
 PYTHON="${PYTHON:-python3}"
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"