This commit is contained in:
Orwa Diraneyya 2021-12-02 12:48:30 +01:00
commit 3b5f06d171
29 changed files with 6659 additions and 15 deletions

View file

@ -5,6 +5,7 @@ variables:
GIT_SUBMODULE_STRATEGY: recursive
test:
allow_failure: true
script:
- hugo
except:

1
CREDIT Normal file
View file

@ -0,0 +1 @@
The credit of this project idea goes to one of our CR Master's students: Kai Azzaoui. Please follow him on SoundCloud here: https://soundcloud.com/user-326328403

View file

@ -1,13 +1,64 @@
![Build Status](https://gitlab.com/pages/hugo/badges/master/build.svg)
# An Example of a Website Development Process
---
Using a Static-Site-Generation tool named _HUGO_ and a repository made up of markdown files, images/videos and HTML templates.
To add your competition entry, you need to clone the repo to your computer using Vscode and then:
Below is a diagram of what happens each time we change the repository:
1. Create a new branch using the version control tab in vscode, please use "`first`-`last`" as the name of the branch where `first` is your first (i.e. _given_) name and `last` is your last (i.e. _family_) name.
2. Rename the visualization video files to "`first`-`no`.mp4" where `first` is your first (i.e. _given_) name and `no` is a sequential number (e.g. "orwa-1.mp4", "orwa-2.mp4", etc.). If you are competing with one entry, then name the file "`first`.mp4" where `first` is your first (i.e. _given_) name.
3. Store the video files in the subfolder `./static/video` in this repository
4. Add your entry article and documentation to `./content/post` in this repository (please use the `2021-12-01-orwa-diraneyya.md` as an example)
5. Commit your changes locally
6. Push your commits to the remote
7. Go to GitLab and create a merge request from there
![HUGO Diagram](./docs/HUGO_big_picture.plain.svg)
In any development team, you have to be on the same page with other developers in the team with regard to:
1. The _file-naming policy_: how to name the files we add to the repo in different directories
1. The _branch-naming policy_: how do we call our branches
1. The _merge-request documentation_:
- when to mark the merge request as a draft,
- how to name the merge request,
- what information to add to the merge-request body
In the session on the 1st of December, 2021 of the DSSIPD course, **we did not have clear policies.** This resulted in a lot of inconsistency which would make managing the development difficult, and hence would be unacceptable in a professional environment.
Hence, when joining a new development team, even if you are a consultant, a content creator, or a manager, it is important to ask how things are expected to be done to maximize the impact of your contributions and to minimize friction with coworkers and line managers.
## Contribution Guidelines to this Repo
In order to mitigate the problems above and to help you grow professionally, we came up with the following guidelines after the session on the 1st of December:
1. **Filenames:** all filenmes should be in small-caps, dashes in-between words, and no spaces/special characters. More specifically:
1. Filenames in `./static/videos/` (for the competition entry videos) use either your first name or your last name, depending on which one is more unique (if both are equally unique, then it is up to you to decide). If more than one video needs to be pushed, use a dash and a number before the extension (e.g. `orwa-1.mp4`, `orwa-2.mp4`)
1. Filenames in `./content/post` (for the competition entry articles) follow the format "`YYYY`-`MM`-`DD`-`first`-`last`.md" (please see the examples in that directory)
1. **Branch names:**
1. For branches adding a new competition entry: use _"competition-`first`-`last`"_ to indicate that it is a branch designating a competition entry and that it belongs to you.
1. For branches fixing an issue: use _"bugfix-issue-`number`"_ where `number` is the issue number.
1. For branches fixing a problem that had not been documented in an issue: use _"bugfix-`first`-`last`"_
1. For other types of improvements after your requirements are met: use _"feature-(`first`|`last`)-`...`"_ where the part _(`A`|`B`)_ means either `A` or `B` and the three dots `...` stand for anything you want assuming it is:
1. All in small caps
1. Uses dashes in-between the words
1. No special characters
1. **Merge request:** please mark the merge request as a draft until you are sure that it runs correctly (using the *preview_website* batch file ran locally) and that all the changes you have made locally are already pushed to your branch on the remote. The title for the merge request should be:
1. "Competition entry for `first` `last`" in case of requesting a merge of a competition entry
1. "Bugfix for issue #`number`" in case of requetsing a merge of a requested change (using the _issues_ feature in GitLab)
1. "Improved `first` `last`'s content" in cae of requesting a merge of an improved `.md` page
In the meantime, we do not require any information or documents to be attached to the body of the merge request.
## Adding a competition entry
After creating your own branch (following the guidelines above). Follow these steps:
1. Look for your video file in the `./static/video` folder on this repo, this has one of two possible outcomes:
1. You found the video file(s), they have been pushed by the instructor from Moodle. Keep note of the filename stem (without the extension), and let's call that `video` and go to step 2 below.
1. The file is not there, because you did not submit on time. In this case, you will have to commit your video file to `./content/video` (please follow the naming guidelines above). The stem of this filename (without the extension) is assume to be `video` in step 2 below.
2. After you identified the video, this is the time to add **a new `.md` file** in the `./content/post` directory of the repo (please follow the naming guidelines above). In this file, please use the contents of `2021-12-01-orwa-diraneyya.md` as a template while changing this line:
```
{{<video "...">}}
```
to include the video filename stem `video` where the three dots `...` are (without the extension).
3. Use the `preview_website.bat` batch file to ensure that the two changes above result in adding your competition entry to the showdown website.
4. Commit the changes above to **your own created branch** and push the chages to the remote.
5. Go to [GitLab.com](https://gitlab.com/rwth-crmasters-wise2122/deep-music-visualizer-showdown) and create a merge request (please follow the merge-requet guidelines above).
## References
- [Deep Music Visualizer](https://github.com/msieg/deep-music-visualizer): Is a repository on GitHub that we use in this project to generate music visualizations from a music file and a list of image classes from a public dataset.
- [HUGO](https://gohugo.io/): Is a computer program that generates a website from a set of `.md` files containing the content, which are formatted using a number of `.html` _Go_ templates.
- [GitLabs CI/CD](https://docs.gitlab.com/ee/ci/yaml/): Is a DevOps system where pushes to GitLab repository triggers a computer script that can then generate something useful, in this case a website.
- [GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/): Is the part of GitLab where GitLab CI/CD generates a website and GitLab provides a URL where this DevOps-generated website can be served.

View file

@ -1,4 +1,4 @@
## Front Page Content
## What is this all about
This website was setup in under 30 minutes using the HUGO project template on GitLab.

View file

@ -0,0 +1,25 @@
---
title: Elif's Visualization
subtitle: Inspired by the trip
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Elif's entry for the competition.
I made a video, I was inspired by the type of music I heard in the Radio Channel.
## Command Variations
I tried different things, the tempo command seems to help me achieve what I wanted to achieve because of this and that.
### Competition Entry
```bash
python `visualize.py` --song `serenade.wav` --batch_size 4 --duration 35 \
--pitch_sensitivity 290 \
--classes 431 435 448 472 512 542 625 626 638 644 701 724 \
--output_file `Elif_Akbas_Serenade`
```
{{<video "elif">}}

View file

@ -0,0 +1,36 @@
---
title: Ziyu's Visualization
subtitle: Inspired by Christmas and DaftPunk
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Ziyu's entry for the competition.
I made two videos, I was inspired by the type of music by DaftPunk
## Command Variations
I tried different things, the tempo command seems to help me achieve what I wanted to achieve because of this and that.
### Competition Entry 1
```bash
python `visualize.py` --song `song file`
--resolution 128 \
--num_classes 4 \
--output_file `video file`
```
{{<video "ziyu-1">}}
### Competition Entry 2
```bash
python `visualize.py` --song `song file` --resolution 128 \
--num_classes 4 \
--classes 470 476 498 496 \
--output_file `video file`
```
{{<video "ziyu-2">}}

View file

@ -16,7 +16,9 @@ Working with different genres of songs and playing with the parameters according
### Competition Entry 1
```bash
python `visualize.py` --song `quesera.wav` --resolution 512 --pitch_sensitivity 280 --tempo_sensitivity 0.6 --depth 0.7 --batch_size 4
python `visualize.py` --song `quesera.wav` --resolution 512
--pitch_sensitivity 280 --tempo_sensitivity 0.6
--depth 0.7 --batch_size 4
```
{{<video "cemre-1">}}
@ -24,8 +26,10 @@ Working with different genres of songs and playing with the parameters according
### Competition Entry 2
```bash
python visualize.py --song 'zuluf.wav' --resolution 512 --pitch_sensitivity 200 --tempo_sensitivity 0.3 \
--depth 0.5 --jitter 0.8 --truncation 0.7 --batch_size 4 --num_classes 12 --classes 471 1 84 56 94 323 325 282 288 292 54 64`
python visualize.py --song 'zuluf.wav' --resolution 512
--pitch_sensitivity 200 --tempo_sensitivity 0.3 --depth 0.5 --jitter 0.8
--truncation 0.7 --batch_size 4 --num_classes 12
--classes 471 1 84 56 94 323 325 282 288 292 54 64`
```
{{<video "cemre-2">}}

View file

@ -0,0 +1,33 @@
---
title: Dominik's Visualization
subtitle: Inspired by Berlin's underground techno parties
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Dominik's entry for the competition.
I made two videos, I was inspired by the type of music I heard at the _underground techno parties_ in Berlin.
## Command Variations
Techno music has high bpm's and a fast pitch change. The video has to be able to follow the fast changes accorddingly, so it is important to adjust the python code to it. The visuals have to support the atmosphere of the music, that's why the pictures have a fast flow and don't stay static.
### Anetha - Acid Train
```bash
python 'visualize.py' --song `song file` --resolution 512 --pitch_sensitivity 1 \
--tempo_sensitivity 0.8 --depth 1 --classes 25 50 75 150 200 400 450 550 670 699 802 969 \
--jitter 0 --frame_length 512 --truncation 0.9 --smooth_factor 5 --batch_size 4 --output_file 'video file'
```
{{<video "dominik-1">}}
### Faithless - Insomnia
```bash
visualize.py --song `song file` --resolution 256 --pitch_sensitivity 299 --tempo_sensitivity 0.1 --depth 0.4 \
--classes 9 38 57 99 145 256 437 666 786 834 890 912 --num_classes 10 --jitter 0.5 --frame_length 1024 \
--truncation 0.4 --smooth_factor 25 --batch_size 5 --output_file `video file`
```
{{<video "dominik-2">}}

View file

@ -0,0 +1,44 @@
---
title: Erich's Visualization
subtitle: Assassin's Creed Soundtrack visualized with my Architecture Background
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Erich's entry for the competition.
I made three videos, I love the Assassin's Creed 2 Soundtrack, so I used Pictures which represent my Architecture Background.
## Command Variations
I finally made it! The quality is better. By adding " --batch_size 5 " I was able to increase the resolution to 512. Still, I think my first ones are better because they stimulate the imagination and more often capture the mood better.I finally made it! The quality is better. By adding " --batch_size 5 " I was able to increase the resolution to 512. Still, I think my first ones are better because they stimulate the imagination and more often capture the mood better.
### Competition Entry 1
```bash
python `visualize.py` --song `song file` --resolution 128 \
--pitch_sensitivity 250 --num_classes 7 \
--classes 497 22 535 624 668 825 821 --output_file `video file`
```
{{<video "erich-1">}}
### Competition Entry 2
```bash
python `visualize.py` --song `song-file` --resolution 128 \
--pitch_sensitivity 150 --num_classes 7 \
--classes 497 22 535 624 668 825 821 --output_file `viedo file`
```
{{<video "erich-2">}}
### Competition Entry 3
```bash
python `visualize.py` --song `song-file` --resolution 512 \
--pitch_sensitivity 150 --num_classes 7 \
--classes 497 22 535 624 668 825 821 --batch_size 5 --output_file `video file`
```
{{<video "erich-3">}}

View file

@ -0,0 +1,32 @@
---
title: Ivana's Visualization
subtitle: Inspired by the famous Northern Macedonia´s fast 7/8 rhythm
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Ivana's project video made by deep-music-visualizer.
I made four videos. I experimented with parametars and the last one proved to be the best one.
## Command Variations
The tempo was very important as the rhythm is quite fast. I was also trying to get in the video more pictures of the people than animals, but in the end I gave up and just used random numbers. Somehow this way I got 2 pictures with people, compered with my previous tries which had none.
### Competition Entry 1
```bash
python `visualize.py` --song `Jovano_Jovanke.wav`
--resolution 512
--duration 30
--pitch_sensitivity 220
--tempo_sensitivity 0.5
--depth 0.7
--classes 44 111 222 333 444 555 666 777 888 999 21 13
--jitter 0.5
--batch_size 4
--output_file `my_song_4.mp4`
```
{{<video "ivana">}}

View file

@ -0,0 +1,15 @@
---
title: Ding's Visualization
subtitle: Inspired by my piano
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
### Competition Entry 1
```bash
python `visualize.py` --song `song file` --resolution 256 --duration 30 --pitch_sensitivity 240 --depth 0.9 --jitter 0.7 --smooth_factor 12 --truncation 0.2 --frame_length 1024 --num_classes 10
--output_file `video file`
```
{{<video "kaiwen">}}

View file

@ -0,0 +1,24 @@
---
title: Mete's Visualization
subtitle: Inspired by my university years
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Mete's entry for the competition.
I made one video, I used to listen metal music when I was at University. This is one of the classics created by a legendary group named AC/DC.
## Command Variations
I tried different things, the jitter command seems to help me achieve what I wanted to achieve because of this and that.
### Competition Entry
```bash
python `visualize.py` --song `song file` --batch_size 1 --duration 27 \
--pitch_sensitivity 230 --jitter 0.3 \
--output_file `video file`
```
{{<video "mete">}}

View file

@ -0,0 +1,24 @@
---
title: Mohamad's Visualization
subtitle: Inspired by my Dutch party visitations in Sittard
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is mohamad's entry for the competition.
I made a video, I was inspired by the type of music I heard in the lo ala albi accoustic version.
## Command Variations
I tried different things, the tempo command seems to help me achieve what I wanted to achieve because of this and that.
### Competition Entry
```bash
python `visualize.py` --song `song file` --batch_size 4
--classes 14 34 873 221 993 74 155 483 7 312 75 738 \
--output_file `video file`
```
{{<video "mohamad-1">}}

View file

@ -0,0 +1,31 @@
---
title: Noureldeen's Visualization
subtitle: Inspired by the different elements in the environment surrounding our life and how it's effected by sound.
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Noureldeen's entry for the competition.
I made one video, I was inspired by the different elements in the enviorment surrounding us and how the sound effects it.
## Command Variations
I played with the variables to test different outputs, I had to increase the smooth factor to visualize my slow music.
### Competition Entry 1
```bash
python `visualize.py` --song `song file` --batch_size 4 --duration 258 \
--resolution 512 --pitch_sensitivity 295 --jitter 0.5 \
--classes 983 980 978 966 954 928 919 889 879 857 288 107 \
--output_file `video file`
```
{{<video "noureldeen">}}

View file

@ -0,0 +1,19 @@
---
title: Omar's Visualization
subtitle: Inspired by Hani Shnoudaa
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
### Competition Entry 1
```bash
python `visualize.py` --song `song file` --batch_size 3 --duration 25 \
--resolution 256 --pitch_sensitivity 290 --jitter 1 \
--classes 847 483 668 724 652 413 269 403 319 353 603 354 \
--output_file `video file`
```
{{<video "omar">}}
>python visualize.py --song longa79.wav --resolution 128 --duration 30 --batch_size 4 --classes 35 39 777 236 49 30 125 198 96 675 874 530

View file

@ -0,0 +1,21 @@
---
title: Panoti's Visualization
subtitle: Following the last assignment related to a music visualization task
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is ********qp**************'s entry for the competition.
I tried too many videos, but I uploaded only one which I think it is the most representable.
## Command Variations
I think the most important think is to choose a song with low tempo and clear sound and harmony change. That will produce interesting and dinstriguishable images.
### Competition Entry 1
```bash
python `visualize.py` --song `stones.wav` --resolution 512 --duration 20 --batch_size 10 --pitch_sensitivity 280
--output_file `stones_batch10_pitch_output.mp4`
```
{{<video `stones_batch10_pitch_output.mp4`>}}

View file

@ -0,0 +1,36 @@
---
title: Seongho's Visualization
subtitle: Inspired by a look at National Geographic.
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Seongho's entry for the competition.
I made two videos, I was inspired by a look at National Geographic.
## Command Variations
I tried various things, tested various options, and got results.
### Competition Entry 1
```bash
python `visualize.py` --song `Dies Irae` --batch_size 4 --duration 46 \
--resolution 512 --pitch_sensitivity 200 --tempo_sensitivity 0.5 --depth 0.3 --jitter 0.2 \
--classes 1 2 3 4 5 6 7 8 9 10 11 12 --frame_length 512 --truncation 0.6 --smooth_factor 2\
--output_file `ha-1`
```
{{<video "ha-1">}}
### Competition Entry 2
```bash
python `visualize.py` --song `New World` --batch_size 4 --duration 46 \
--classes 24 77 86 47 85 97 72 63 43 45 66 92 --frame_length 512 --truncation 0.6 --smooth_factor 2 \
--resolution 512 --pitch_sensitivity 200 --tempo_sensitivity 0.5 --depth 0.3 --jitter 0.2 --output_file `ha-2`
```
{{<video "ha-2">}}

View file

@ -0,0 +1,30 @@
---
title: Timur's Visualization
subtitle: Inspired by some music I found online
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Timur's entry for the competition.
I made two videos, I was inspired by some license-free music tracks I found online.
## Command Variations
I did some trial and error changing various different settings for the deep music visualizer and combining it with animal as well as spacecraft image libraries.
### Competition Entry 1
```bash
python visualize.py --song 8-bit_game_theme.wav --resolution 512 --duration 30 --pitch_sensitivity 240 --tempo_sensitivity 0.3 --depth 0.9 --num_classes 1 --classes 812 --sort_classes_by_power 1 --jitter 0.65 --frame_length 512 --truncation 0.5 --smooth_factor 16 --batch_size 30 --use_previous_classes 0 --use_previous_vectors 0 --output_file 8bit_game_theme_video.mp4
```
{{<video "timur-1">}}
### Competition Entry 2
```bash
python visualize.py --song lo-fi_guitar.wav --resolution 512 --duration 30 --pitch_sensitivity 250 --tempo_sensitivity 0.45 --depth 0.75 --num_classes 6 --sort_classes_by_power 1 --jitter 0.75 --frame_length 512 --truncation 0.8 --smooth_factor 22 --batch_size 30 --use_previous_classes 0 --use_previous_vectors 0 --output_file lo-fi_guitar_video.mp4
```
{{<video "timur-2">}}

View file

@ -0,0 +1,18 @@
---
title: Yanran's Visualization
subtitle: Inspired by an Opera in Shanghai
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
### Competition Entry 1
```bash
python `visualize.py` --song `song file` --duration 43 --depth 0.5 \
--batch_size 4 --pitch_sensitivity 220 \
--tempo_sensitivity 0.07 --num_classes 8 --frame_length 1024 \
--truncation 0.1 --smooth_factor 40 --jitter 0.2 \
--output_file `video file`
```
{{<video "yanran">}}

View file

@ -0,0 +1,26 @@
---
title: Yasmin's Visualization
subtitle: Inspired by my Special dates and childhood favorite song
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Yasmin's entry for the competition.
I made this video, I was inspired by one of my childhood favorite songs _Dessert Rose_ in Egypt.
## Command Variations
I tried different things, I run out of memory and i tried to change the batch size to get it work.
### Competition Entry
```bash
python `visualize.py` --song `song file` --batch_size 4 --duration 60 \
--resolution 512 --pitch_sensitivity 220 --jitter 1 \
--classes 169 662 199 234 197 23 19 21 40 200 10 1 \
--output_file `video file`
```
{{<video "yasmin">}}

View file

@ -0,0 +1,26 @@
---
title: Beyza's Visualization
subtitle: Inspired by travelling
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Orwa's entry for the competition.
I made one video, I was inspired by the song called taro. This song usually reminds me of travelling.
## Command Variations
I tried different things, but as I changed things get less interesting. I havent created a note for the classes I used, I picked random numbers sequentials. I have other videos as well, one with birds and other with dos but haven´t uploaded.
### Competition Entry
```bash
python `visualize.py` --song `taro.wav` --batch_size 4\
--resolution 512 --jitter 0.7 \
--classes \
--output_file `video file`
```
{{<video "beyzanur">}}

22
content/post/ali Normal file
View file

@ -0,0 +1,22 @@
---
title: Ali zargham's Visualization
subtitle: Inspired by romantic guitar of sub-continent
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Ali's entry for the competition.
## Command Variations
I tried different things, I changed the music audio to be a romantic guitar. I made one videos, I was inspired by the romantic guitar in the sub-continent.Traditionally musical traditions have been passed on orally and musical skills have often been taught from father to son or teacher to pupil. Students pay respect to their instructors by kissing their feet. The relationship between teachers (known as pandits and gurus among Hindus and ustaad among Muslims) and their pupils is very important in Indian music. Teachers and pupils are often related, and the spiritual element of the instrument is often as important as technical virtuosity. In northern India, the spiritual relationship is symbolized by a ceremony in which a teachers ties a string around the wrist of a pupil
### Competition Entry 1
```bash
python 'visualize.py' --song 'romantic_guitar.wav' --output_file 'romantic-music.mp4' --batch_size 4`
```
{{<video "ali">}}

20
content/post/makwana.md Normal file
View file

@ -0,0 +1,20 @@
---
title: Makwana's Visualization
subtitle: Inspired by my Dutch party visitations in Sittard
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Makwana's entry for the competition.
## Command Variations
I tried simple thing.
### Competition Entry 1
```bash
python visualize.py --song beethoven.mp3 --resolution 128 --output_file `video file`
```
{{<video "makwana">}}

35
content/post/saeed-r.md Normal file
View file

@ -0,0 +1,35 @@
---
title: saeed's Visualization
subtitle: Inspired by my Dutch party visitations in Sittard
date: 2021-12-01
tags: ["music-visualizer", "competition"]
---
This is Orwa's entry for the competition.
I made three videos, I was inspired by the type of music I heard in the _Soulfully Yours_ parties in Holland.
## Command Variations
I tried different things, the tempo command seems to help me achieve what I wanted to achieve because of this and that.
### Competition Entry 1
```bash
python `visualize.py` --song `song file` --batch_size 3 --duration 25 \
--resolution 256 --pitch_sensitivity 290 --jitter 1 \
--classes 847 483 668 724 652 413 269 403 319 353 603 354 \
--output_file `video file`
```
{{<video "saeed-1">}}
### Competition Entry 2
```bash
python `visualize.py` --song `song file` --batch_size 3 \
--classes 847 483 668 724 652 413 269 403 319 353 603 354 \
--resolution 512 --jitter 1 --output_file `video file`
```
{{<video "saeed-2">}}

Binary file not shown.

File diff suppressed because it is too large Load diff

After

Width:  |  Height:  |  Size: 505 KiB

View file

@ -1,3 +1,3 @@
start "" http://localhost:1313
start "" http://localhost:1313/deep-music-visualizer-showdown/
bin\hugo server
pause

BIN
static/video/Noureldeen.mp4 Normal file

Binary file not shown.

BIN
static/video/kaiwending.mp4 Normal file

Binary file not shown.