https://github.com/pxgo/go-fm

GoFM is a cross-platform real-time audio streaming server for MP3 files, written in Go. It allows synchronized playback across multiple clients.
https://github.com/pxgo/go-fm

audio audio-streaming fm golang radio

Last synced: 3 months ago
JSON representation

GoFM is a cross-platform real-time audio streaming server for MP3 files, written in Go. It allows synchronized playback across multiple clients.

• Host: GitHub
• URL: https://github.com/pxgo/go-fm
• Owner: pxgo
• License: mit
• Created: 2023-04-22T13:56:42.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-04-05T13:55:20.000Z (6 months ago)
• Last Synced: 2025-04-12T13:00:45.768Z (6 months ago)
• Topics: audio, audio-streaming, fm, golang, radio
• Language: Go
• Homepage: https://stackstore.net/GoFM
• Size: 935 KB
• Stars: 28
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
GoFM

=====

GoFM is a cross-platform real-time audio streaming server written in Go. It allows you to stream MP3 audio files from a specified directory over HTTP and synchronize playback across multiple clients.

[![Go Version](https://img.shields.io/badge/Go-v1.16-blue)](https://golang.org/dl/)

[![Go Report Card](https://goreportcard.com/badge/github.com/pxgo/go-fm)](https://goreportcard.com/report/github.com/pxgo/go-fm)

[![Downloads](https://img.shields.io/github/downloads/pxgo/go-fm/total)](https://github.com/pxgo/go-fm/releases)

[![References](https://img.shields.io/github/forks/pxgo/go-fm?label=references)](https://github.com/pxgo/go-fm/network/members)

[![License](https://img.shields.io/github/license/pxgo/go-fm)](https://github.com/pxgo/go-fm/blob/main/LICENSE)

![GoFM](./statics/GoFM_home.png)

## Usage

To use GoFM, download the latest release from the [Releases page](https://github.com/pxgo/go-fm/releases) and run the server with the following command:

```

./GoFM -d /path/to/your/music/directory

```

By default, GoFM listens on port 8090. You can customize the server's behavior using the following command-line options:

```

-p int

    Specifies the server port number (default 8090).

-host string

    Specifies the server host address (default "0.0.0.0").

-r

    Enables random playback mode.

-debug

    Enables debug mode for the server.

-d string

    Specifies the directory to play audio files from (default "/path/to/your/music/directory").

-h

    Shows help information.

-n string

    Specifies the name of the FM (default "GoFM").

```

For example, to change the server's port number to 8080, use the -p option followed by the desired port number, like this:

```

./GoFM -d /path/to/your/music/directory -p 8080

```

You can find more information about GoFM on [STACKSTORE](https://stackstore.net/GoFM).

## License

GoFM is released under the [MIT License](https://github.com/pxgo/go-fm/blob/main/LICENSE). Feel free to use, modify, and distribute the software. Contributions are welcome!