Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/SteeBono/airplayreceiver

Open source implementation of AirPlay 2 Mirroring / Audio protocol.
https://github.com/SteeBono/airplayreceiver

airplay airplay-receiver airplay-remote airplay-server airplay2 apple appletv csharp linux macos mirroring netcore test windows

Last synced: 9 days ago
JSON representation

Open source implementation of AirPlay 2 Mirroring / Audio protocol.

Awesome Lists containing this project

README

        

# AirPlay Receiver
Open source implementation of AirPlay 2 Mirroring / Audio protocol in C# .Net Core.

## Generic

Tested on macOS with iPhone 12 Pro iOS14.

The project is fully functional, but the AAC and ALAC libraries written in C ++ must be built.

## How To

### Build AAC Codec
To download, build and install fdk-aac do the following:

Clone the repository and cd into the folder:
```
$ git clone https://github.com/mstorsjo/fdk-aac.git
$ cd fdk-aac
```

Configure the build and make the library:
```
$ autoreconf -fi
$ ./configure
$ make
```

### Build ALAC Codec
To download, build and install alac do the following:

Clone the repository and cd into the folder:
```
$ git clone https://github.com/mikebrady/alac.git
$ cd alac
```

Download and paste 'GiteKat''s files in 'alac/codec' folder cloned before
```
$ https://github.com/GiteKat/LibALAC/tree/master/LibALAC
```

The 'mikebrady''s source code does not contains 'extern' keyword.
We need external linkage so we use 'GiteKat''s source code files.

Edit makefile.original as follow

```
# libalac make

CFLAGS = -g -O3 -c
LFLAGS = -Wall
CC = g++

SRCDIR = .
OBJDIR = ./obj
INCLUDES = .

HEADERS = \
$(SRCDIR)/EndianPortable.h \
$(SRCDIR)/aglib.h \
$(SRCDIR)/ALACAudioTypes.h \
$(SRCDIR)/ALACBitUtilities.h\
$(SRCDIR)/ALACDecoder.h \
$(SRCDIR)/ALACEncoder.h \
$(SRCDIR)/LibALAC.h \
$(SRCDIR)/dplib.h \
$(SRCDIR)/matrixlib.h

SOURCES = \
$(SRCDIR)/EndianPortable.c \
$(SRCDIR)/ALACBitUtilities.c \
$(SRCDIR)/ALACDecoder.cpp \
$(SRCDIR)/ALACEncoder.cpp \
$(SRCDIR)/LibALAC.cpp \
$(SRCDIR)/ag_dec.c \
$(SRCDIR)/ag_enc.c \
$(SRCDIR)/dp_dec.c \
$(SRCDIR)/dp_enc.c \
$(SRCDIR)/matrix_dec.c \
$(SRCDIR)/matrix_enc.c

OBJS = \
EndianPortable.o \
ALACBitUtilities.o \
ALACDecoder.o \
ALACEncoder.o \
LibALAC.o \
ag_dec.o \
ag_enc.o \
dp_dec.o \
dp_enc.o \
matrix_dec.o \
matrix_enc.o

libalac.a: $(OBJS)
ar rcs libalac.a $(OBJS)

EndianPortable.o : EndianPortable.c
$(CC) -I $(INCLUDES) $(CFLAGS) EndianPortable.c

ALACBitUtilities.o : ALACBitUtilities.c
$(CC) -I $(INCLUDES) $(CFLAGS) ALACBitUtilities.c

ALACDecoder.o : ALACDecoder.cpp
$(CC) -I $(INCLUDES) $(CFLAGS) ALACDecoder.cpp

ALACEncoder.o : ALACEncoder.cpp
$(CC) -I $(INCLUDES) $(CFLAGS) ALACEncoder.cpp

LibALAC.o : LibALAC.cpp
$(CC) -I $(INCLUDES) $(CFLAGS) LibALAC.cpp

ag_dec.o : ag_dec.c
$(CC) -I $(INCLUDES) $(CFLAGS) ag_dec.c

ag_enc.o : ag_enc.c
$(CC) -I $(INCLUDES) $(CFLAGS) ag_enc.c

dp_dec.o : dp_dec.c
$(CC) -I $(INCLUDES) $(CFLAGS) dp_dec.c

dp_enc.o : dp_enc.c
$(CC) -I $(INCLUDES) $(CFLAGS) dp_enc.c

matrix_dec.o : matrix_dec.c
$(CC) -I $(INCLUDES) $(CFLAGS) matrix_dec.c

matrix_enc.o : matrix_enc.c
$(CC) -I $(INCLUDES) $(CFLAGS) matrix_enc.c

clean:
-rm $(OBJS) libalac.a
```

Edit makefile.am as follow


```
## Copyright (c) 2013 Tiancheng "Timothy" Gu
## Modifications copyright (c) 2016 Mike Brady
## Licensed under the Apache License, Version 2.0 (the "License");
## you may not use this file except in compliance with the License.
## You may obtain a copy of the License at
##
## http://www.apache.org/licenses/LICENSE-2.0
##
## Unless required by applicable law or agreed to in writing, software
## distributed under the License is distributed on an "AS IS" BASIS,
## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
## See the License for the specific language governing permissions and
## limitations under the License.

lib_LTLIBRARIES = libalac.la

libalac_la_CPPFLAGS = -Wno-multichar
libalac_la_LDFLAGS = -version-info @ALAC_VERSION@

libalac_la_SOURCES = \
EndianPortable.c \
ALACBitUtilities.c \
ALACDecoder.cpp \
ALACEncoder.cpp \
LibALAC.cpp \
ag_dec.c \
ag_enc.c \
dp_dec.c \
dp_enc.c \
matrix_dec.c \
matrix_enc.c

pkgconfigdir = $(libdir)/pkgconfig
pkgconfig_DATA = alac.pc

# Install to include/alac
alacincludedir = $(includedir)/alac

# Install everything
alacinclude_HEADERS = *.h
```

Configure the build and make the library:
```
$ autoreconf -fi
$ ./configure
$ make
```

### Linux
On terminal type the follow to install build tools
```
apt-get install build-essential autoconf automake libtool
```
Add compiled DLL path into 'appsettings_linux.json' file.

### MacOS
On terminal type the follow to install build tools

```
brew install autoconf automake libtool
```
Add compiled DLL path into 'appsettings_osx.json' file.

### Windows

Use [this](http://www.gaia-gis.it/gaia-sins/mingw64_how_to.html#env) tutorial to understand how to install build tools and how to compile source code on Windows.
You need MinGW32 or MinGW64 based on arch.

Put repo folders inside msys64 home folder ('C:\msys64\home\').
![homefolder](https://user-images.githubusercontent.com/11635557/116857182-b0b9b180-abfc-11eb-8e75-5d1b23d7541f.PNG)

Start an mingw32.exe or mingw64.exe shell based on arch and execute commands.
![mingwshell](https://user-images.githubusercontent.com/11635557/116857648-756bb280-abfd-11eb-8d6b-43d474f4a27b.PNG)

The compiled dll will be saved in 'C:\\msys64\\home\\username\\fdk-aac-master\\.libs\\'.
Add compiled DLL path into 'appsettings_win.json' file.

TIP 1: If the ALAC library gives you an error during the compilation try to insert the following arguments in the 'makefile.am' file:
```
libalac_la_LDFLAGS = -version-info @ALAC_VERSION@ -no-undefined -static-libgcc -static-libstdc++
```
TIP 2: If the error code 126 appears when loading the dll, try to import all the dlls located in the C:\msys64\bin\ folder into the bin folder of the project.
TIP 3: If the error code 193 appears when loading the dll, it means that you are trying to load a dll with the wrong architecture, so you have to compile the dll with the other mingwXX.exe.

## Wiki

Here you will find an [Article](https://github.com/SteeBono/airplayreceiver/wiki/AirPlay2-Protocol) where I explain how the whole AirPlay 2 protocol works.

## Disclamier

All the resources in this repository are written using only opensource projects.
The code and related resources are meant for educational purposes only.
I do not take any responsibility for the use that will be made of it.

## Credits

Inspired by others AirPlay open source projects.
Big ty to OmgHax.c's author 😱.

## If you want support me 🔥

If you appreciate my work, consider buying me a cup of coffee to keep me recharged ☕

Buy Me A Coffee

... or ... crypto ...

BTC: 1BXhfC5U75G2H8b99wk5AedGFxtqJ6xf8q
BCH: 1BXhfC5U75G2H8b99wk5AedGFxtqJ6xf8q
ETH: 0x4Fc12c7C71C581aBc77945Ab9cFBA8DF9692b713 (ERC20)