raspberrypilearning · ninaszymor · Jan 21, 2025 · Jan 21, 2025 · Jan 21, 2025 · Jan 21, 2025
diff --git a/af-ZA/images/8-background-annotated.png b/af-ZA/images/8-background-annotated.png
diff --git a/af-ZA/images/8-background.png b/af-ZA/images/8-background.png
diff --git a/af-ZA/images/8-left.png b/af-ZA/images/8-left.png
diff --git a/af-ZA/images/8-right-annotated.png b/af-ZA/images/8-right-annotated.png
diff --git a/af-ZA/images/8-right.png b/af-ZA/images/8-right.png
diff --git a/af-ZA/images/add-example-annotated.png b/af-ZA/images/add-example-annotated.png
diff --git a/af-ZA/images/alien-language.png b/af-ZA/images/alien-language.png
diff --git a/af-ZA/images/allow-microphone.png b/af-ZA/images/allow-microphone.png
diff --git a/af-ZA/images/background-noise-annotated.png b/af-ZA/images/background-noise-annotated.png
diff --git a/af-ZA/images/background-noise.png b/af-ZA/images/background-noise.png
diff --git a/af-ZA/images/click-train.png b/af-ZA/images/click-train.png
diff --git a/af-ZA/images/control-alien-blocks.png b/af-ZA/images/control-alien-blocks.png
diff --git a/af-ZA/images/create-project.png b/af-ZA/images/create-project.png
diff --git a/af-ZA/images/create.png b/af-ZA/images/create.png
diff --git a/af-ZA/images/extensions-annotated.png b/af-ZA/images/extensions-annotated.png
diff --git a/af-ZA/images/learn-test-annotated.png b/af-ZA/images/learn-test-annotated.png
diff --git a/af-ZA/images/left-empty-annotated.png b/af-ZA/images/left-empty-annotated.png
diff --git a/af-ZA/images/make-annotated.png b/af-ZA/images/make-annotated.png
diff --git a/af-ZA/images/new-blocks.png b/af-ZA/images/new-blocks.png
diff --git a/af-ZA/images/project-train.png b/af-ZA/images/project-train.png
diff --git a/af-ZA/images/projects-list.png b/af-ZA/images/projects-list.png
diff --git a/af-ZA/images/record-button.png b/af-ZA/images/record-button.png
diff --git a/af-ZA/images/save-example-annotated.png b/af-ZA/images/save-example-annotated.png
diff --git a/af-ZA/images/start-listening-annotated.png b/af-ZA/images/start-listening-annotated.png
diff --git a/af-ZA/images/test-your-model.png b/af-ZA/images/test-your-model.png
diff --git a/af-ZA/images/train-annotated.png b/af-ZA/images/train-annotated.png
diff --git a/af-ZA/images/train-new-model.png b/af-ZA/images/train-new-model.png
diff --git a/af-ZA/images/whatyouwillmake.gif b/af-ZA/images/whatyouwillmake.gif
diff --git a/af-ZA/meta.yml b/af-ZA/meta.yml
@@ -8,22 +8,26 @@ copyedit: true
 technologies: scratch
 software: scratch
 version: 4.0.0
-last_tested: "2019-06-04"
+last_tested: '2019-06-04'
 steps:
   - 
-    title: Introduction
+    title: What you will make
   - 
-    title: Use a pretrained model
+    title: Set up the project
   - 
-    title: Create a new project
+    title: Invent two words
+    completion:
+      - engaged
   - 
-    title: Create alien words
+    title: Train the model
   - 
-    title: Train a new machine learning model
+    title: Control the alien
+    completion:
+      - internal
   - 
-    title: Use alien words in Scratch
-  - 
-    title: "Challenge: add new commands"
+    title: 'Challenge'
     challenge: true
   - 
-    title: What next?
+    title: What can you do now?
+    completion:
+      - external
diff --git a/af-ZA/resources/NEW Alien 1.mp4 b/af-ZA/resources/NEW Alien 1.mp4
diff --git a/af-ZA/resources/NEW Alien 1.srt b/af-ZA/resources/NEW Alien 1.srt
@@ -0,0 +1,26 @@
+1
+00:00:04,760 --> 00:00:11,520
+Go to rpf.io/ML4K and click 'Get started'.
+
+2
+00:00:11,520 --> 00:00:15,560
+Click 'Try it now'.
+
+3
+00:00:15,560 --> 00:00:20,560
+Add a new project called 'Alien language'.
+
+4
+00:00:20,560 --> 00:00:28,280
+Set the project type to 'recognising sound,' 
+and the storage to 'in your browser'.
+
+5
+00:00:28,280 --> 00:00:34,840
+Create the project, then 
+click on the project title.
+
+6
+00:00:34,840 --> 00:00:40,000
+Now click on 'Train'.
+
diff --git a/af-ZA/resources/NEW Alien 2.mp4 b/af-ZA/resources/NEW Alien 2.mp4
diff --git a/af-ZA/resources/NEW Alien 2.srt b/af-ZA/resources/NEW Alien 2.srt
@@ -0,0 +1,25 @@
+1
+00:00:03,600 --> 00:00:07,160
+Allow the site to access 
+your microphone if it asks.
+
+2
+00:00:07,160 --> 00:00:12,440
+Record a sample of background 
+noise - so just don't say anything.
+
+3
+00:00:12,440 --> 00:00:17,800
+Now repeat that until you have 
+eight samples of background noise.
+
+4
+00:00:17,800 --> 00:00:27,040
+Add a label for left, and record your 
+made up alien word for left, eight times.
+
+5
+00:00:27,040 --> 00:00:38,120
+Next, add a label for right and record 
+a different made up word, eight times.
+
diff --git a/af-ZA/resources/NEW Alien 3.mp4 b/af-ZA/resources/NEW Alien 3.mp4
diff --git a/af-ZA/resources/NEW Alien 3.srt b/af-ZA/resources/NEW Alien 3.srt
@@ -0,0 +1,16 @@
+1
+00:00:04,160 --> 00:00:11,320
+Click 'Back', then click on 'Learn & Test'.
+
+2
+00:00:11,320 --> 00:00:15,520
+It's time to train your model!
+
+3
+00:00:15,520 --> 00:00:19,160
+Test the model by saying one of your words:
+
+4
+00:00:19,160 --> 00:00:27,520
+Bloop!
+
diff --git a/af-ZA/resources/NEW Alien 4.mp4 b/af-ZA/resources/NEW Alien 4.mp4
diff --git a/af-ZA/resources/NEW Alien 4.srt b/af-ZA/resources/NEW Alien 4.srt
@@ -0,0 +1,35 @@
+1
+00:00:04,680 --> 00:00:08,640
+Now click 'Back' again, and 
+this time choose 'Make'.
+
+2
+00:00:08,640 --> 00:00:14,160
+Let's use the model in Scratch!
+
+3
+00:00:14,160 --> 00:00:21,920
+Go to 'Project templates' and select 
+the template for 'Alien language'.
+
+4
+00:00:21,920 --> 00:00:24,360
+Some code has been added for you.
+
+5
+00:00:24,360 --> 00:00:29,960
+Drag the code blocks to make 
+the alien move when you speak.
+
+6
+00:00:36,800 --> 00:00:40,800
+Let's test it out.
+
+7
+00:00:40,800 --> 00:00:43,840
+Bloop!
+
+8
+00:00:43,840 --> 00:00:50,200
+Wow!
+
diff --git a/af-ZA/resources/readme.txt b/af-ZA/resources/readme.txt
@@ -0,0 +1 @@
+To watch a video with subtitles on VLC (videolan.org), ensure the video file and subtitle file are in the same folder and have the exact same name (e.g., video.mp4 and video.srt). Open the video in VLC, and it will automatically load the subtitles. If the subtitles don’t appear, right-click the video screen, go to **Subtitle**, then **Add Subtitle File**, and select the correct .srt file. Enjoy watching with subtitles!
diff --git a/af-ZA/step_1.md b/af-ZA/step_1.md
@@ -1,53 +1,44 @@
-## Introduction
+## What you will make
 
-In this project, you will train the computer to understand an alien language. You will use that to control an alien character so that it can understand what you tell it to do.
+Train a machine learning model to recognise an alien language and use it in Scratch to control an alien.
 
-### What you will make
+You will need a **microphone**.
 
-\--- no-print \---
+![An alien moving left and right with the commands Eek and Bop](images/whatyouwillmake.gif)
 
-![Alien moving left and right to new words, Eeek and Bop](images/journey.gif)
+--- collapse ---
 
-\--- /no-print \---
-
-\--- print-only \---
+---
+title: Where are my voice recordings stored?
+---
 
-![Overview of entire Scratch project](images/test-new-blocks.png)
+- This project uses a technology called 'machine learning'. Machine learning systems are trained using a large amount of data.
+- This project does not require you to create an account or log in. For this project, the examples you use to make the model are only stored temporarily in your browser (only on your machine).
 
-\--- /print-only \---
+--- /collapse ---
 
-\--- collapse \---
+--- collapse ---
 ---
-title: What you will need
+title: No YouTube? Download the videos!
 ---
 
-+ A computer with a microphone
+You can [download all the videos for this project](https://rpf.io/p/en/alien-language-go){:target="_blank"}.
 
-+ Internet access
 
-\--- /collapse \---
+--- /collapse ---
 
-\--- collapse \---
+--- collapse ---
 ---
-title: What you will learn
+title: License
 ---
-+ How to use the Speech to Text extension in Scratch 3 with a pretrained model
-+ How to train a machine learning model to recognise sounds
-+ How to use your trained machine learning model in Scratch 3
 
-\--- /collapse \---
+This project is dual-licensed under both a [Creative Commons Attribution Non-Commercial Share-Alike License](http://creativecommons.org/licenses/by-nc-sa/4.0/){:target="_blank"} and an [Apache License Version 2.0](http://www.apache.org/licenses/LICENSE-2.0){:target="_blank"}.
 
-\--- collapse \---
----
-title: Additional information for educators
----
+We'd like to thank Dale from machinelearningforkids.co.uk for all his work on this project.
+
+--- /collapse ---
 
-If you need to print this project, please use the [printer-friendly version](https://projects.raspberrypi.org/en/projects/alien-language/print){:target="_blank"}.
 
-\--- /collapse \---
 
-### Licence
 
-This project is dual-licensed under both a [Creative Commons Attribution Non-Commercial Share-Alike License](http://creativecommons.org/licenses/by-nc-sa/4.0/){:target="_blank"} and an [Apache License Version 2.0](http://www.apache.org/licenses/LICENSE-2.0){:target="_blank"}
 
-We'd like to thank Dale from machinelearningforkids.co.uk for all his work on this project.
diff --git a/af-ZA/step_2.md b/af-ZA/step_2.md
@@ -1,22 +1,42 @@
-## Use a pretrained model
+## Set up the project
 
-\--- task \---
-+ Go to [machinelearningforkids.co.uk/scratch3](https://machinelearningforkids.co.uk/scratch3/){:target="_blank"}
-\--- /task \---
+<html>
+  <div style="position: relative; overflow: hidden; padding-top: 56.25%;">
+    <iframe style="position: absolute; top: 0; left: 0; right: 0; width: 100%; height: 100%; border: none;" src="https://www.youtube.com/embed/KdybBTJ979k?rel=0&cc_load_policy=1" allowfullscreen allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe>
+  </div>
+</html>
 
-**Warning:** This step of the project can only be completed using the Google Chrome web browser. If this browser is not available to you, please skip to [step 3: Create a new project](https://projects.raspberrypi.org/en/projects/alien-language/3)
+--- task ---
 
-\--- task \---
-+ Next, load the **Speech to Text** extension. Click the **Extensions** button in the bottom left-hand corner, and then choose **Speech to Text** from the list. **Note:** Make sure that you select the **Speech to Text** extension, not the **Text to Speech** extension. ![Arrow pointing to extensions button](images/extensions-annotated.png)
++ Go to [machinelearningforkids.co.uk](https://machinelearningforkids.co.uk/){:target="_blank"} in a web browser.
 
-+ Use **Events** blocks, **Motions** blocks, and the new **Speech to Text** blocks to create the following scripts. ![New scripts to add](images/S-to-T-blocks.png)
++ Click on **Get started**.
 
-\--- /task \---
++ Click on **Try it now**.
 
-\--- task \--- Click on the green flag to test your program. Say “left” or “right”. The Scratch cat should move in the direction that you tell it to. Use your voice to try to move the Scratch cat back and forth across the screen. Try to speak calmly and clearly.
+--- /task ---
+
+--- task ---
+
++ Click on **Projects** in the menu bar at the top.
+
++ Click on the **+ Add a new project** button.
+
++ Name your project `Alien language` and set it to learn to recognise **sounds**, and store data **in your web browser**. Then click on **Create**. ![Creating a project](images/create-project.png)
+
++ You should now see 'Alien language' in the projects list. Click on the project. ![Project list with alien language listed](images/projects-list.png)
+
+--- /task ---
+
+--- task ---
+
++ Click on the **Train** button. ![Project main menu with an arrow pointing to the train button](images/project-train.png)
+
++ If you see a pop-up message asking to use the microphone, click on **Allow on every visit**.
+
+![Popup asking you to allow the microphone, with an arrow pointing to allow every visit](images/allow-microphone.png)
+
+--- /task ---
 
-It can be difficult to get it to work. If it doesn’t work, add `say` blocks so that your script looks like the script below, to show what it thinks you are saying. ![New scripts to see what the computer thinks you are saying](images/S-to-T-blocks-test.png) \--- /task \---
 
-You have now used speech recognition to control a character in Scratch.
 
-In this step, to get your program working quickly, you used a machine learning model that had already been trained for you. It is a general machine learning model that had been trained to recognise words in the English dictionary. 
diff --git a/af-ZA/step_3.md b/af-ZA/step_3.md
@@ -1,20 +1,49 @@
-## Create a new project
-In the next few steps, you will train a machine learning model to see how it was done. For the next part of the project, you will use your voice to control an alien character that does not understand English! You will invent two new words that would not be found in an English dictionary. Then, you will use the words to control the alien character, and train a machine learning model to recognise them.
+## Invent two words
 
-First, go to the Machine Learning for Kids website and create a project.
+<html>
+  <div style="position: relative; overflow: hidden; padding-top: 56.25%;">
+    <iframe style="position: absolute; top: 0; left: 0; right: 0; width: 100%; height: 100%; border: none;" src="https://www.youtube.com/embed/au4cDSYW_EQ?rel=0&cc_load_policy=1" allowfullscreen allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe>
+  </div>
+</html>
 
-\--- task \---
-+ Go to [machinelearningforkids.co.uk](https://machinelearningforkids.co.uk/){:target="_blank"}.
+First, you will collect samples of background noise. This will help your machine learning model to tell the difference between the sounds that you will train it to recognise, and the background noise where you are.
 
-+ Click on **Get started**.
+--- task ---
 
-+ Click on **Try it now**. \--- /task \---
++ Click the **+ Add example** button in **background noise**.
 
-\--- task \---
-+ Click on **Projects** in the menu bar at the top of the page.
++ Click on the microphone, but don't say anything. Record 2 seconds of background noise. ![Arrow pointing to microphone button](images/record-button.png)
 
-+ Click the **Add a new project** button.
++ Click the **Add** button to save your recording.
 
-+ Name your project `Alien Language` and set it to learn how to recognise `sounds`. Then, click the **Create** button. ![Creating a project](images/create.png)
+--- /task ---
 
-+ You should see `Alien Language` in the projects list. Click on the `Alien Language` project. \--- /task \---
+--- task ---
+
++ Repeat those steps until you have **at least eight examples** of background noise. ![Bucket filled with 8 background examples](images/8-background.png)
+
+--- /task ---
+
+Invent two alien words — a word that means "left" and a word that means "right".
+
+Now you will record eight examples of each word so that your machine learning model can learn to recognise them.
+
+--- task ---
+
++ Click on **+ Add new label** on the top right of the screen and add a label called `left`.
+
+--- /task ---
+
+--- task ---
+
++ Click on **+ Add example** inside the box for the new `left` label, and record yourself saying your alien word for "left".
+
++ Repeat until you have recorded **at least eight examples**.
+
+--- /task ---
+
+--- task ---
+
++ Click on **+ Add new label** to create another label called `right` and record eight examples of your alien word for "right".
+
+--- /task ---
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		To watch a video with subtitles on VLC (videolan.org), ensure the video file and subtitle file are in the same folder and have the exact same name (e.g., video.mp4 and video.srt). Open the video in VLC, and it will automatically load the subtitles. If the subtitles don’t appear, right-click the video screen, go to Subtitle, then Add Subtitle File, and select the correct .srt file. Enjoy watching with subtitles!