diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 4a8295d..eadf7b7 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -21,7 +21,7 @@
@@ -508,15 +508,8 @@
-
-
-
-
- 1741544086061
-
-
-
- 1741544086061
+
+
@@ -902,7 +895,15 @@
1751893722720
-
+
+
+ 1751894332017
+
+
+
+ 1751894332017
+
+
@@ -949,7 +950,6 @@
-
@@ -974,7 +974,8 @@
-
+
+
false
diff --git a/src/components/input/ToolAudioInput.tsx b/src/components/input/ToolAudioInput.tsx
new file mode 100644
index 0000000..c9090a7
--- /dev/null
+++ b/src/components/input/ToolAudioInput.tsx
@@ -0,0 +1,46 @@
+import React, { useRef } from 'react';
+import { Box, Typography } from '@mui/material';
+import BaseFileInput from './BaseFileInput';
+import { BaseFileInputProps } from './file-input-utils';
+
+interface AudioFileInputProps extends Omit {
+ accept?: string[];
+}
+
+export default function ToolAudioInput({
+ accept = ['audio/*', '.mp3', '.wav', '.aac'],
+ ...props
+}: AudioFileInputProps) {
+ const audioRef = useRef(null);
+
+ return (
+
+ {({ preview }) => (
+
+ {preview ? (
+
+ ) : (
+
+ Drag & drop or import an audio file
+
+ )}
+
+ )}
+
+ );
+}
diff --git a/src/components/input/ToolMultipleAudioInput.tsx b/src/components/input/ToolMultipleAudioInput.tsx
new file mode 100644
index 0000000..daba468
--- /dev/null
+++ b/src/components/input/ToolMultipleAudioInput.tsx
@@ -0,0 +1,172 @@
+import { ReactNode, useContext, useEffect, useRef, useState } from 'react';
+import { Box, useTheme } from '@mui/material';
+import Typography from '@mui/material/Typography';
+import InputHeader from '../InputHeader';
+import InputFooter from './InputFooter';
+import { CustomSnackBarContext } from '../../contexts/CustomSnackBarContext';
+import { isArray } from 'lodash';
+import MusicNoteIcon from '@mui/icons-material/MusicNote';
+
+interface MultiAudioInputComponentProps {
+ accept: string[];
+ title?: string;
+ type: 'audio';
+ value: MultiAudioInput[];
+ onChange: (file: MultiAudioInput[]) => void;
+}
+
+export interface MultiAudioInput {
+ file: File;
+ order: number;
+}
+
+export default function ToolMultipleAudioInput({
+ value,
+ onChange,
+ accept,
+ title,
+ type
+}: MultiAudioInputComponentProps) {
+ const fileInputRef = useRef(null);
+
+ const handleFileChange = (event: React.ChangeEvent) => {
+ const files = event.target.files;
+ if (files)
+ onChange([
+ ...value,
+ ...Array.from(files).map((file) => ({ file, order: value.length }))
+ ]);
+ };
+
+ const handleImportClick = () => {
+ fileInputRef.current?.click();
+ };
+
+ function handleClear() {
+ onChange([]);
+ }
+
+ function fileNameTruncate(fileName: string) {
+ const maxLength = 15;
+ if (fileName.length > maxLength) {
+ return fileName.slice(0, maxLength) + '...';
+ }
+ return fileName;
+ }
+
+ const sortList = () => {
+ const list = [...value];
+ list.sort((a, b) => a.order - b.order);
+ onChange(list);
+ };
+
+ const reorderList = (sourceIndex: number, destinationIndex: number) => {
+ if (destinationIndex === sourceIndex) {
+ return;
+ }
+ const list = [...value];
+
+ if (destinationIndex === 0) {
+ list[sourceIndex].order = list[0].order - 1;
+ sortList();
+ return;
+ }
+
+ if (destinationIndex === list.length - 1) {
+ list[sourceIndex].order = list[list.length - 1].order + 1;
+ sortList();
+ return;
+ }
+
+ if (destinationIndex < sourceIndex) {
+ list[sourceIndex].order =
+ (list[destinationIndex].order + list[destinationIndex - 1].order) / 2;
+ sortList();
+ return;
+ }
+
+ list[sourceIndex].order =
+ (list[destinationIndex].order + list[destinationIndex + 1].order) / 2;
+ sortList();
+ };
+
+ return (
+
+
+
+
+ {value?.length ? (
+ value.map((file, index) => (
+
+
+
+
+ {fileNameTruncate(file.file.name)}
+
+
+ {
+ const updatedFiles = value.filter((_, i) => i !== index);
+ onChange(updatedFiles);
+ }}
+ >
+ ✖
+
+
+ ))
+ ) : (
+
+ No files selected
+
+ )}
+
+
+
+
+
+
+ );
+}
diff --git a/src/pages/tools/audio/change-speed/change-speed.service.test.ts b/src/pages/tools/audio/change-speed/change-speed.service.test.ts
new file mode 100644
index 0000000..0ebd463
--- /dev/null
+++ b/src/pages/tools/audio/change-speed/change-speed.service.test.ts
@@ -0,0 +1,46 @@
+import { expect, describe, it, vi } from 'vitest';
+
+// Mock FFmpeg since it doesn't support Node.js
+vi.mock('@ffmpeg/ffmpeg', () => ({
+ FFmpeg: vi.fn().mockImplementation(() => ({
+ loaded: false,
+ load: vi.fn().mockResolvedValue(undefined),
+ writeFile: vi.fn().mockResolvedValue(undefined),
+ exec: vi.fn().mockResolvedValue(undefined),
+ readFile: vi.fn().mockResolvedValue(new Uint8Array([1, 2, 3, 4, 5])),
+ deleteFile: vi.fn().mockResolvedValue(undefined)
+ }))
+}));
+
+vi.mock('@ffmpeg/util', () => ({
+ fetchFile: vi.fn().mockResolvedValue(new Uint8Array([1, 2, 3, 4, 5]))
+}));
+
+import { changeAudioSpeed } from './service';
+import { InitialValuesType } from './types';
+
+describe('changeAudioSpeed', () => {
+ it('should return a new File with the correct name and type', async () => {
+ const mockAudioData = new Uint8Array([0, 1, 2, 3, 4, 5]);
+ const mockFile = new File([mockAudioData], 'test.mp3', {
+ type: 'audio/mp3'
+ });
+ const options: InitialValuesType = {
+ newSpeed: 2,
+ outputFormat: 'mp3'
+ };
+ const result = await changeAudioSpeed(mockFile, options);
+ expect(result).toBeInstanceOf(File);
+ expect(result?.name).toBe('test-2x.mp3');
+ expect(result?.type).toBe('audio/mp3');
+ });
+
+ it('should return null if input is null', async () => {
+ const options: InitialValuesType = {
+ newSpeed: 2,
+ outputFormat: 'mp3'
+ };
+ const result = await changeAudioSpeed(null, options);
+ expect(result).toBeNull();
+ });
+});
diff --git a/src/pages/tools/audio/change-speed/index.tsx b/src/pages/tools/audio/change-speed/index.tsx
new file mode 100644
index 0000000..e799814
--- /dev/null
+++ b/src/pages/tools/audio/change-speed/index.tsx
@@ -0,0 +1,120 @@
+import { Box, FormControlLabel, Radio, RadioGroup } from '@mui/material';
+import React, { useState } from 'react';
+import ToolContent from '@components/ToolContent';
+import { ToolComponentProps } from '@tools/defineTool';
+import { GetGroupsType } from '@components/options/ToolOptions';
+import { InitialValuesType } from './types';
+import ToolAudioInput from '@components/input/ToolAudioInput';
+import ToolFileResult from '@components/result/ToolFileResult';
+import TextFieldWithDesc from '@components/options/TextFieldWithDesc';
+import RadioWithTextField from '@components/options/RadioWithTextField';
+import { changeAudioSpeed } from './service';
+
+const initialValues: InitialValuesType = {
+ newSpeed: 2,
+ outputFormat: 'mp3'
+};
+
+const formatOptions = [
+ { label: 'MP3', value: 'mp3' },
+ { label: 'AAC', value: 'aac' },
+ { label: 'WAV', value: 'wav' }
+];
+
+export default function ChangeSpeed({
+ title,
+ longDescription
+}: ToolComponentProps) {
+ const [input, setInput] = useState(null);
+ const [result, setResult] = useState(null);
+ const [loading, setLoading] = useState(false);
+
+ const compute = async (
+ optionsValues: InitialValuesType,
+ input: File | null
+ ) => {
+ setLoading(true);
+ try {
+ const newFile = await changeAudioSpeed(input, optionsValues);
+ setResult(newFile);
+ } catch (err) {
+ setResult(null);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ const getGroups: GetGroupsType | null = ({
+ values,
+ updateField
+ }) => [
+ {
+ title: 'New Audio Speed',
+ component: (
+
+ updateField('newSpeed', Number(val))}
+ description="Default multiplier: 2 means 2x faster"
+ type="number"
+ />
+
+ )
+ },
+ {
+ title: 'Output Format',
+ component: (
+
+
+ updateField(
+ 'outputFormat',
+ e.target.value as 'mp3' | 'aac' | 'wav'
+ )
+ }
+ >
+ {formatOptions.map((opt) => (
+ }
+ label={opt.label}
+ />
+ ))}
+
+
+ )
+ }
+ ];
+ return (
+
+ }
+ resultComponent={
+ loading ? (
+
+ ) : (
+
+ )
+ }
+ initialValues={initialValues}
+ getGroups={getGroups}
+ setInput={setInput}
+ compute={compute}
+ toolInfo={{ title: `What is ${title}?`, description: longDescription }}
+ />
+ );
+}
diff --git a/src/pages/tools/audio/change-speed/meta.ts b/src/pages/tools/audio/change-speed/meta.ts
new file mode 100644
index 0000000..a23d674
--- /dev/null
+++ b/src/pages/tools/audio/change-speed/meta.ts
@@ -0,0 +1,13 @@
+import { defineTool } from '@tools/defineTool';
+import { lazy } from 'react';
+
+export const tool = defineTool('audio', {
+ name: 'Change speed',
+ path: 'change-speed',
+ icon: 'material-symbols-light:speed-outline',
+ description:
+ 'This online utility lets you change the speed of an audio. You can speed it up or slow it down.',
+ shortDescription: 'Quickly change audio speed',
+ keywords: ['change', 'speed'],
+ component: lazy(() => import('./index'))
+});
diff --git a/src/pages/tools/audio/change-speed/service.ts b/src/pages/tools/audio/change-speed/service.ts
new file mode 100644
index 0000000..c6e6663
--- /dev/null
+++ b/src/pages/tools/audio/change-speed/service.ts
@@ -0,0 +1,80 @@
+import { InitialValuesType } from './types';
+import { FFmpeg } from '@ffmpeg/ffmpeg';
+import { fetchFile } from '@ffmpeg/util';
+
+function computeAudioFilter(speed: number): string {
+ if (speed <= 2 && speed >= 0.5) {
+ return `atempo=${speed}`;
+ }
+ const filters: string[] = [];
+ let remainingSpeed = speed;
+ while (remainingSpeed > 2.0) {
+ filters.push('atempo=2.0');
+ remainingSpeed /= 2.0;
+ }
+ while (remainingSpeed < 0.5) {
+ filters.push('atempo=0.5');
+ remainingSpeed /= 0.5;
+ }
+ filters.push(`atempo=${remainingSpeed.toFixed(2)}`);
+ return filters.join(',');
+}
+
+export async function changeAudioSpeed(
+ input: File | null,
+ options: InitialValuesType
+): Promise {
+ if (!input) return null;
+ const { newSpeed, outputFormat } = options;
+ let ffmpeg: FFmpeg | null = null;
+ let ffmpegLoaded = false;
+ try {
+ ffmpeg = new FFmpeg();
+ if (!ffmpegLoaded) {
+ await ffmpeg.load({
+ wasmURL:
+ 'https://cdn.jsdelivr.net/npm/@ffmpeg/core@0.12.9/dist/esm/ffmpeg-core.wasm'
+ });
+ ffmpegLoaded = true;
+ }
+ const fileName = input.name;
+ const outputName = `output.${outputFormat}`;
+ await ffmpeg.writeFile(fileName, await fetchFile(input));
+ const audioFilter = computeAudioFilter(newSpeed);
+ let args = ['-i', fileName, '-filter:a', audioFilter];
+ if (outputFormat === 'mp3') {
+ args.push('-b:a', '192k', '-f', 'mp3', outputName);
+ } else if (outputFormat === 'aac') {
+ args.push('-c:a', 'aac', '-b:a', '192k', '-f', 'adts', outputName);
+ } else if (outputFormat === 'wav') {
+ args.push(
+ '-acodec',
+ 'pcm_s16le',
+ '-ar',
+ '44100',
+ '-ac',
+ '2',
+ '-f',
+ 'wav',
+ outputName
+ );
+ }
+ await ffmpeg.exec(args);
+ const data = await ffmpeg.readFile(outputName);
+ let mimeType = 'audio/mp3';
+ if (outputFormat === 'aac') mimeType = 'audio/aac';
+ if (outputFormat === 'wav') mimeType = 'audio/wav';
+ const blob = new Blob([data], { type: mimeType });
+ const newFile = new File(
+ [blob],
+ fileName.replace(/\.[^/.]+$/, `-${newSpeed}x.${outputFormat}`),
+ { type: mimeType }
+ );
+ await ffmpeg.deleteFile(fileName);
+ await ffmpeg.deleteFile(outputName);
+ return newFile;
+ } catch (err) {
+ console.error(`Failed to process audio: ${err}`);
+ return null;
+ }
+}
diff --git a/src/pages/tools/audio/change-speed/types.ts b/src/pages/tools/audio/change-speed/types.ts
new file mode 100644
index 0000000..587fc4f
--- /dev/null
+++ b/src/pages/tools/audio/change-speed/types.ts
@@ -0,0 +1,4 @@
+export type InitialValuesType = {
+ newSpeed: number;
+ outputFormat: 'mp3' | 'aac' | 'wav';
+};
diff --git a/src/pages/tools/audio/extract-audio/extract-audio.service.test.ts b/src/pages/tools/audio/extract-audio/extract-audio.service.test.ts
new file mode 100644
index 0000000..88624b9
--- /dev/null
+++ b/src/pages/tools/audio/extract-audio/extract-audio.service.test.ts
@@ -0,0 +1,50 @@
+import { describe, it, expect, vi, beforeAll } from 'vitest';
+
+// Mock the service module BEFORE importing it
+vi.mock('./service', () => ({
+ extractAudioFromVideo: vi.fn(async (input, options) => {
+ const ext = options.outputFormat;
+ return new File([new Blob(['audio data'])], `mock_audio.${ext}`, {
+ type: `audio/${ext}`
+ });
+ })
+}));
+
+import { extractAudioFromVideo } from './service';
+import { InitialValuesType } from './types';
+
+function createMockVideoFile(): File {
+ return new File(['video data'], 'test.mp4', { type: 'video/mp4' });
+}
+
+describe('extractAudioFromVideo (mocked)', () => {
+ let videoFile: File;
+
+ beforeAll(() => {
+ videoFile = createMockVideoFile();
+ });
+
+ it('should extract audio as AAC', async () => {
+ const options: InitialValuesType = { outputFormat: 'aac' };
+ const audioFile = await extractAudioFromVideo(videoFile, options);
+ expect(audioFile).toBeInstanceOf(File);
+ expect(audioFile.name.endsWith('.aac')).toBe(true);
+ expect(audioFile.type).toBe('audio/aac');
+ });
+
+ it('should extract audio as MP3', async () => {
+ const options: InitialValuesType = { outputFormat: 'mp3' };
+ const audioFile = await extractAudioFromVideo(videoFile, options);
+ expect(audioFile).toBeInstanceOf(File);
+ expect(audioFile.name.endsWith('.mp3')).toBe(true);
+ expect(audioFile.type).toBe('audio/mp3');
+ });
+
+ it('should extract audio as WAV', async () => {
+ const options: InitialValuesType = { outputFormat: 'wav' };
+ const audioFile = await extractAudioFromVideo(videoFile, options);
+ expect(audioFile).toBeInstanceOf(File);
+ expect(audioFile.name.endsWith('.wav')).toBe(true);
+ expect(audioFile.type).toBe('audio/wav');
+ });
+});
diff --git a/src/pages/tools/audio/extract-audio/index.tsx b/src/pages/tools/audio/extract-audio/index.tsx
new file mode 100644
index 0000000..f5012ec
--- /dev/null
+++ b/src/pages/tools/audio/extract-audio/index.tsx
@@ -0,0 +1,91 @@
+import { Box } from '@mui/material';
+import React, { useState } from 'react';
+import ToolContent from '@components/ToolContent';
+import { ToolComponentProps } from '@tools/defineTool';
+import { extractAudioFromVideo } from './service';
+import { InitialValuesType } from './types';
+import ToolVideoInput from '@components/input/ToolVideoInput';
+import { GetGroupsType } from '@components/options/ToolOptions';
+import ToolFileResult from '@components/result/ToolFileResult';
+import SelectWithDesc from '@components/options/SelectWithDesc';
+
+const initialValues: InitialValuesType = {
+ outputFormat: 'aac'
+};
+
+export default function ExtractAudio({
+ title,
+ longDescription
+}: ToolComponentProps) {
+ const [file, setFile] = useState(null);
+ const [audioFile, setAudioFile] = useState(null);
+ const [loading, setLoading] = useState(false);
+
+ const getGroups: GetGroupsType = ({
+ values,
+ updateField
+ }) => {
+ return [
+ {
+ title: 'Output Format',
+ component: (
+
+ {
+ updateField('outputFormat', value.toString());
+ }}
+ options={[
+ { label: 'AAC', value: 'aac' },
+ { label: 'MP3', value: 'mp3' },
+ { label: 'WAV', value: 'wav' }
+ ]}
+ description={
+ 'Select the format for the audio to be extracted as.'
+ }
+ />
+
+ )
+ }
+ ];
+ };
+
+ const compute = async (values: InitialValuesType, input: File | null) => {
+ if (!input) return;
+ try {
+ setLoading(true);
+ const audioFileObj = await extractAudioFromVideo(input, values);
+ setAudioFile(audioFileObj);
+ } catch (err) {
+ console.error(err);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ return (
+
+ }
+ resultComponent={
+ loading ? (
+
+ ) : (
+
+ )
+ }
+ initialValues={initialValues}
+ getGroups={getGroups}
+ compute={compute}
+ toolInfo={{ title: `What is ${title}?`, description: longDescription }}
+ setInput={setFile}
+ />
+ );
+}
diff --git a/src/pages/tools/audio/extract-audio/meta.ts b/src/pages/tools/audio/extract-audio/meta.ts
new file mode 100644
index 0000000..a89afe8
--- /dev/null
+++ b/src/pages/tools/audio/extract-audio/meta.ts
@@ -0,0 +1,26 @@
+import { defineTool } from '@tools/defineTool';
+import { lazy } from 'react';
+
+export const tool = defineTool('audio', {
+ name: 'Extract audio',
+ path: 'extract-audio',
+ icon: 'mdi:music-note',
+ description:
+ 'Extract the audio track from a video file and save it as a separate audio file in your chosen format (AAC, MP3, WAV).',
+ shortDescription:
+ 'Extract audio from video files (MP4, MOV, etc.) to AAC, MP3, or WAV.',
+ keywords: [
+ 'extract',
+ 'audio',
+ 'video',
+ 'mp3',
+ 'aac',
+ 'wav',
+ 'audio extraction',
+ 'media',
+ 'convert'
+ ],
+ longDescription:
+ 'This tool allows you to extract the audio track from a video file (such as MP4, MOV, AVI, etc.) and save it as a standalone audio file in your preferred format (AAC, MP3, or WAV). Useful for podcasts, music, or any scenario where you need just the audio from a video.',
+ component: lazy(() => import('./index'))
+});
diff --git a/src/pages/tools/audio/extract-audio/service.ts b/src/pages/tools/audio/extract-audio/service.ts
new file mode 100644
index 0000000..e9bb578
--- /dev/null
+++ b/src/pages/tools/audio/extract-audio/service.ts
@@ -0,0 +1,70 @@
+import { FFmpeg } from '@ffmpeg/ffmpeg';
+import { fetchFile } from '@ffmpeg/util';
+import { InitialValuesType } from './types';
+
+const ffmpeg = new FFmpeg();
+
+export async function extractAudioFromVideo(
+ input: File,
+ options: InitialValuesType
+): Promise {
+ if (!ffmpeg.loaded) {
+ await ffmpeg.load({
+ wasmURL:
+ 'https://cdn.jsdelivr.net/npm/@ffmpeg/core@0.12.9/dist/esm/ffmpeg-core.wasm'
+ });
+ }
+
+ const inputName = 'input.mp4';
+ await ffmpeg.writeFile(inputName, await fetchFile(input));
+
+ const configuredOutputAudioFormat = options.outputFormat;
+ const outputName = `output.${configuredOutputAudioFormat}`;
+ const args: string[] = ['-i', inputName, '-vn'];
+
+ if (configuredOutputAudioFormat === 'mp3') {
+ args.push(
+ '-ar',
+ '44100',
+ '-ac',
+ '2',
+ '-b:a',
+ '192k',
+ '-f',
+ 'mp3',
+ outputName
+ );
+ } else if (configuredOutputAudioFormat === 'wav') {
+ args.push(
+ '-acodec',
+ 'pcm_s16le',
+ '-ar',
+ '44100',
+ '-ac',
+ '2',
+ '-f',
+ 'wav',
+ outputName
+ );
+ } else {
+ // Default to AAC or copy
+ args.push('-acodec', 'copy', outputName);
+ }
+
+ await ffmpeg.exec(args);
+
+ const extractedAudio = await ffmpeg.readFile(outputName);
+
+ return new File(
+ [
+ new Blob([extractedAudio], {
+ type: `audio/${configuredOutputAudioFormat}`
+ })
+ ],
+ `${input.name.replace(
+ /\.[^/.]+$/,
+ ''
+ )}_audio.${configuredOutputAudioFormat}`,
+ { type: `audio/${configuredOutputAudioFormat}` }
+ );
+}
diff --git a/src/pages/tools/audio/extract-audio/types.ts b/src/pages/tools/audio/extract-audio/types.ts
new file mode 100644
index 0000000..d6d4f36
--- /dev/null
+++ b/src/pages/tools/audio/extract-audio/types.ts
@@ -0,0 +1,3 @@
+export type InitialValuesType = {
+ outputFormat: string;
+};
diff --git a/src/pages/tools/audio/index.ts b/src/pages/tools/audio/index.ts
new file mode 100644
index 0000000..3596a1c
--- /dev/null
+++ b/src/pages/tools/audio/index.ts
@@ -0,0 +1,11 @@
+import { tool as audioMergeAudio } from './merge-audio/meta';
+import { tool as audioTrim } from './trim/meta';
+import { tool as audioChangeSpeed } from './change-speed/meta';
+import { tool as audioExtractAudio } from './extract-audio/meta';
+
+export const audioTools = [
+ audioExtractAudio,
+ audioChangeSpeed,
+ audioTrim,
+ audioMergeAudio
+];
diff --git a/src/pages/tools/audio/merge-audio/index.tsx b/src/pages/tools/audio/merge-audio/index.tsx
new file mode 100644
index 0000000..09acd35
--- /dev/null
+++ b/src/pages/tools/audio/merge-audio/index.tsx
@@ -0,0 +1,112 @@
+import { Box, FormControlLabel, Radio, RadioGroup } from '@mui/material';
+import React, { useState } from 'react';
+import ToolContent from '@components/ToolContent';
+import { ToolComponentProps } from '@tools/defineTool';
+import { GetGroupsType } from '@components/options/ToolOptions';
+import { InitialValuesType } from './types';
+import ToolMultipleAudioInput, {
+ MultiAudioInput
+} from '@components/input/ToolMultipleAudioInput';
+import ToolFileResult from '@components/result/ToolFileResult';
+import { mergeAudioFiles } from './service';
+
+const initialValues: InitialValuesType = {
+ outputFormat: 'mp3'
+};
+
+const formatOptions = [
+ { label: 'MP3', value: 'mp3' },
+ { label: 'AAC', value: 'aac' },
+ { label: 'WAV', value: 'wav' }
+];
+
+export default function MergeAudio({
+ title,
+ longDescription
+}: ToolComponentProps) {
+ const [input, setInput] = useState([]);
+ const [result, setResult] = useState(null);
+ const [loading, setLoading] = useState(false);
+
+ const compute = async (
+ optionsValues: InitialValuesType,
+ input: MultiAudioInput[]
+ ) => {
+ if (input.length === 0) return;
+ setLoading(true);
+ try {
+ const files = input.map((item) => item.file);
+ const mergedFile = await mergeAudioFiles(files, optionsValues);
+ setResult(mergedFile);
+ } catch (err) {
+ console.error(`Failed to merge audio: ${err}`);
+ setResult(null);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ const getGroups: GetGroupsType | null = ({
+ values,
+ updateField
+ }) => [
+ {
+ title: 'Output Format',
+ component: (
+
+
+ updateField(
+ 'outputFormat',
+ e.target.value as 'mp3' | 'aac' | 'wav'
+ )
+ }
+ >
+ {formatOptions.map((opt) => (
+ }
+ label={opt.label}
+ />
+ ))}
+
+
+ )
+ }
+ ];
+
+ return (
+
+ }
+ resultComponent={
+ loading ? (
+
+ ) : (
+
+ )
+ }
+ initialValues={initialValues}
+ getGroups={getGroups}
+ setInput={setInput}
+ compute={compute}
+ toolInfo={{ title: `What is ${title}?`, description: longDescription }}
+ />
+ );
+}
diff --git a/src/pages/tools/audio/merge-audio/merge-audio.service.test.ts b/src/pages/tools/audio/merge-audio/merge-audio.service.test.ts
new file mode 100644
index 0000000..6bdaaab
--- /dev/null
+++ b/src/pages/tools/audio/merge-audio/merge-audio.service.test.ts
@@ -0,0 +1,73 @@
+import { expect, describe, it, vi } from 'vitest';
+
+// Mock FFmpeg since it doesn't support Node.js
+vi.mock('@ffmpeg/ffmpeg', () => ({
+ FFmpeg: vi.fn().mockImplementation(() => ({
+ loaded: false,
+ load: vi.fn().mockResolvedValue(undefined),
+ writeFile: vi.fn().mockResolvedValue(undefined),
+ exec: vi.fn().mockResolvedValue(undefined),
+ readFile: vi.fn().mockResolvedValue(new Uint8Array([1, 2, 3, 4, 5])),
+ deleteFile: vi.fn().mockResolvedValue(undefined)
+ }))
+}));
+
+vi.mock('@ffmpeg/util', () => ({
+ fetchFile: vi.fn().mockResolvedValue(new Uint8Array([1, 2, 3, 4, 5]))
+}));
+
+import { mergeAudioFiles } from './service';
+
+describe('mergeAudioFiles', () => {
+ it('should merge multiple audio files', async () => {
+ // Create mock audio files
+ const mockAudioData1 = new Uint8Array([0, 1, 2, 3, 4, 5]);
+ const mockAudioData2 = new Uint8Array([6, 7, 8, 9, 10, 11]);
+
+ const mockFile1 = new File([mockAudioData1], 'test1.mp3', {
+ type: 'audio/mp3'
+ });
+ const mockFile2 = new File([mockAudioData2], 'test2.mp3', {
+ type: 'audio/mp3'
+ });
+
+ const options = {
+ outputFormat: 'mp3' as const
+ };
+
+ const result = await mergeAudioFiles([mockFile1, mockFile2], options);
+ expect(result).toBeInstanceOf(File);
+ expect(result.name).toBe('merged_audio.mp3');
+ expect(result.type).toBe('audio/mp3');
+ });
+
+ it('should handle different output formats', async () => {
+ const mockAudioData = new Uint8Array([0, 1, 2, 3, 4, 5]);
+ const mockFile = new File([mockAudioData], 'test.wav', {
+ type: 'audio/wav'
+ });
+
+ const options = {
+ outputFormat: 'aac' as const
+ };
+
+ const result = await mergeAudioFiles([mockFile], options);
+ expect(result).toBeInstanceOf(File);
+ expect(result.name).toBe('merged_audio.aac');
+ expect(result.type).toBe('audio/aac');
+ });
+
+ it('should throw error when no input files provided', async () => {
+ const options = {
+ outputFormat: 'mp3' as const
+ };
+
+ try {
+ await mergeAudioFiles([], options);
+ expect.fail('Should have thrown an error');
+ } catch (error) {
+ expect(error).toBeInstanceOf(Error);
+ expect((error as Error).message).toBe('No input files provided');
+ }
+ });
+});
diff --git a/src/pages/tools/audio/merge-audio/meta.ts b/src/pages/tools/audio/merge-audio/meta.ts
new file mode 100644
index 0000000..dc1775a
--- /dev/null
+++ b/src/pages/tools/audio/merge-audio/meta.ts
@@ -0,0 +1,26 @@
+import { defineTool } from '@tools/defineTool';
+import { lazy } from 'react';
+
+export const tool = defineTool('audio', {
+ name: 'Merge Audio',
+ path: 'merge-audio',
+ icon: 'fluent:merge-20-regular',
+ description:
+ 'Combine multiple audio files into a single audio file by concatenating them in sequence.',
+ shortDescription: 'Merge multiple audio files into one (MP3, AAC, WAV).',
+ keywords: [
+ 'merge',
+ 'audio',
+ 'combine',
+ 'concatenate',
+ 'join',
+ 'mp3',
+ 'aac',
+ 'wav',
+ 'audio editing',
+ 'multiple files'
+ ],
+ longDescription:
+ 'This tool allows you to merge multiple audio files into a single file by concatenating them in the order you upload them. Perfect for combining podcast segments, music tracks, or any audio files that need to be joined together. Supports various audio formats including MP3, AAC, and WAV.',
+ component: lazy(() => import('./index'))
+});
diff --git a/src/pages/tools/audio/merge-audio/service.ts b/src/pages/tools/audio/merge-audio/service.ts
new file mode 100644
index 0000000..802bf04
--- /dev/null
+++ b/src/pages/tools/audio/merge-audio/service.ts
@@ -0,0 +1,115 @@
+import { FFmpeg } from '@ffmpeg/ffmpeg';
+import { fetchFile } from '@ffmpeg/util';
+import { InitialValuesType } from './types';
+
+const ffmpeg = new FFmpeg();
+
+export async function mergeAudioFiles(
+ inputs: File[],
+ options: InitialValuesType
+): Promise {
+ if (!ffmpeg.loaded) {
+ await ffmpeg.load({
+ wasmURL:
+ 'https://cdn.jsdelivr.net/npm/@ffmpeg/core@0.12.9/dist/esm/ffmpeg-core.wasm'
+ });
+ }
+
+ if (inputs.length === 0) {
+ throw new Error('No input files provided');
+ }
+
+ const { outputFormat } = options;
+ const outputName = `output.${outputFormat}`;
+
+ // 1. Convert all inputs to WAV
+ const tempWavNames: string[] = [];
+ for (let i = 0; i < inputs.length; i++) {
+ const inputName = `input${i}`;
+ const tempWavName = `temp${i}.wav`;
+ await ffmpeg.writeFile(inputName, await fetchFile(inputs[i]));
+ await ffmpeg.exec([
+ '-i',
+ inputName,
+ '-acodec',
+ 'pcm_s16le',
+ '-ar',
+ '44100',
+ '-ac',
+ '2',
+ tempWavName
+ ]);
+ tempWavNames.push(tempWavName);
+ await ffmpeg.deleteFile(inputName);
+ }
+
+ // 2. Create file list for concat
+ const fileListName = 'filelist.txt';
+ const fileListContent = tempWavNames
+ .map((name) => `file '${name}'`)
+ .join('\n');
+ await ffmpeg.writeFile(fileListName, fileListContent);
+
+ // 3. Concatenate WAV files
+ const concatWav = 'concat.wav';
+ await ffmpeg.exec([
+ '-f',
+ 'concat',
+ '-safe',
+ '0',
+ '-i',
+ fileListName,
+ '-c',
+ 'copy',
+ concatWav
+ ]);
+
+ // 4. Convert concatenated WAV to requested output format
+ let finalOutput = concatWav;
+ if (outputFormat !== 'wav') {
+ const args = ['-i', concatWav];
+ if (outputFormat === 'mp3') {
+ args.push(
+ '-ar',
+ '44100',
+ '-ac',
+ '2',
+ '-b:a',
+ '192k',
+ '-f',
+ 'mp3',
+ outputName
+ );
+ } else if (outputFormat === 'aac') {
+ args.push('-c:a', 'aac', '-b:a', '192k', '-f', 'adts', outputName);
+ }
+ await ffmpeg.exec(args);
+ finalOutput = outputName;
+ }
+
+ const mergedAudio = await ffmpeg.readFile(finalOutput);
+
+ let mimeType = 'audio/wav';
+ if (outputFormat === 'mp3') mimeType = 'audio/mp3';
+ if (outputFormat === 'aac') mimeType = 'audio/aac';
+
+ // Clean up files
+ for (const tempWavName of tempWavNames) {
+ await ffmpeg.deleteFile(tempWavName);
+ }
+ await ffmpeg.deleteFile(fileListName);
+ await ffmpeg.deleteFile(concatWav);
+ if (outputFormat !== 'wav') {
+ await ffmpeg.deleteFile(outputName);
+ }
+
+ return new File(
+ [
+ new Blob([mergedAudio], {
+ type: mimeType
+ })
+ ],
+ `merged_audio.${outputFormat}`,
+ { type: mimeType }
+ );
+}
diff --git a/src/pages/tools/audio/merge-audio/types.ts b/src/pages/tools/audio/merge-audio/types.ts
new file mode 100644
index 0000000..2a7c90c
--- /dev/null
+++ b/src/pages/tools/audio/merge-audio/types.ts
@@ -0,0 +1,3 @@
+export type InitialValuesType = {
+ outputFormat: 'mp3' | 'aac' | 'wav';
+};
diff --git a/src/pages/tools/audio/trim/index.tsx b/src/pages/tools/audio/trim/index.tsx
new file mode 100644
index 0000000..07fed95
--- /dev/null
+++ b/src/pages/tools/audio/trim/index.tsx
@@ -0,0 +1,128 @@
+import { Box, FormControlLabel, Radio, RadioGroup } from '@mui/material';
+import React, { useState } from 'react';
+import ToolContent from '@components/ToolContent';
+import { ToolComponentProps } from '@tools/defineTool';
+import { GetGroupsType } from '@components/options/ToolOptions';
+import { InitialValuesType } from './types';
+import ToolAudioInput from '@components/input/ToolAudioInput';
+import ToolFileResult from '@components/result/ToolFileResult';
+import TextFieldWithDesc from '@components/options/TextFieldWithDesc';
+import { trimAudio } from './service';
+
+const initialValues: InitialValuesType = {
+ startTime: '00:00:00',
+ endTime: '00:01:00',
+ outputFormat: 'mp3'
+};
+
+const formatOptions = [
+ { label: 'MP3', value: 'mp3' },
+ { label: 'AAC', value: 'aac' },
+ { label: 'WAV', value: 'wav' }
+];
+
+export default function Trim({ title, longDescription }: ToolComponentProps) {
+ const [input, setInput] = useState(null);
+ const [result, setResult] = useState(null);
+ const [loading, setLoading] = useState(false);
+
+ const compute = async (
+ optionsValues: InitialValuesType,
+ input: File | null
+ ) => {
+ if (!input) return;
+ setLoading(true);
+ try {
+ const trimmedFile = await trimAudio(input, optionsValues);
+ setResult(trimmedFile);
+ } catch (err) {
+ console.error(`Failed to trim audio: ${err}`);
+ setResult(null);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ const getGroups: GetGroupsType | null = ({
+ values,
+ updateField
+ }) => [
+ {
+ title: 'Time Settings',
+ component: (
+
+ updateField('startTime', val)}
+ description="Start time in format HH:MM:SS (e.g., 00:00:30)"
+ label="Start Time"
+ />
+
+ updateField('endTime', val)}
+ description="End time in format HH:MM:SS (e.g., 00:01:30)"
+ label="End Time"
+ />
+
+
+ )
+ },
+ {
+ title: 'Output Format',
+ component: (
+
+
+ updateField(
+ 'outputFormat',
+ e.target.value as 'mp3' | 'aac' | 'wav'
+ )
+ }
+ >
+ {formatOptions.map((opt) => (
+ }
+ label={opt.label}
+ />
+ ))}
+
+
+ )
+ }
+ ];
+
+ return (
+
+ }
+ resultComponent={
+ loading ? (
+
+ ) : (
+
+ )
+ }
+ initialValues={initialValues}
+ getGroups={getGroups}
+ setInput={setInput}
+ compute={compute}
+ toolInfo={{ title: `What is ${title}?`, description: longDescription }}
+ />
+ );
+}
diff --git a/src/pages/tools/audio/trim/meta.ts b/src/pages/tools/audio/trim/meta.ts
new file mode 100644
index 0000000..a4f36e3
--- /dev/null
+++ b/src/pages/tools/audio/trim/meta.ts
@@ -0,0 +1,27 @@
+import { defineTool } from '@tools/defineTool';
+import { lazy } from 'react';
+
+export const tool = defineTool('audio', {
+ name: 'Trim Audio',
+ path: 'trim',
+ icon: 'mdi:scissors-cutting',
+ description:
+ 'Cut and trim audio files to extract specific segments by specifying start and end times.',
+ shortDescription:
+ 'Trim audio files to extract specific time segments (MP3, AAC, WAV).',
+ keywords: [
+ 'trim',
+ 'audio',
+ 'cut',
+ 'segment',
+ 'extract',
+ 'mp3',
+ 'aac',
+ 'wav',
+ 'audio editing',
+ 'time'
+ ],
+ longDescription:
+ 'This tool allows you to trim audio files by specifying start and end times. You can extract specific segments from longer audio files, remove unwanted parts, or create shorter clips. Supports various audio formats including MP3, AAC, and WAV. Perfect for podcast editing, music production, or any audio editing needs.',
+ component: lazy(() => import('./index'))
+});
diff --git a/src/pages/tools/audio/trim/service.ts b/src/pages/tools/audio/trim/service.ts
new file mode 100644
index 0000000..e17f78a
--- /dev/null
+++ b/src/pages/tools/audio/trim/service.ts
@@ -0,0 +1,108 @@
+import { FFmpeg } from '@ffmpeg/ffmpeg';
+import { fetchFile } from '@ffmpeg/util';
+import { InitialValuesType } from './types';
+
+const ffmpeg = new FFmpeg();
+
+export async function trimAudio(
+ input: File,
+ options: InitialValuesType
+): Promise {
+ if (!ffmpeg.loaded) {
+ await ffmpeg.load({
+ wasmURL:
+ 'https://cdn.jsdelivr.net/npm/@ffmpeg/core@0.12.9/dist/esm/ffmpeg-core.wasm'
+ });
+ }
+
+ const inputName = 'input.mp3';
+ await ffmpeg.writeFile(inputName, await fetchFile(input));
+
+ const { startTime, endTime, outputFormat } = options;
+ const outputName = `output.${outputFormat}`;
+
+ // Build FFmpeg arguments for trimming
+ let args: string[] = [
+ '-i',
+ inputName,
+ '-ss',
+ startTime, // Start time
+ '-to',
+ endTime, // End time
+ '-c',
+ 'copy' // Copy without re-encoding for speed
+ ];
+
+ // Add format-specific arguments
+ if (outputFormat === 'mp3') {
+ args = [
+ '-i',
+ inputName,
+ '-ss',
+ startTime,
+ '-to',
+ endTime,
+ '-ar',
+ '44100',
+ '-ac',
+ '2',
+ '-b:a',
+ '192k',
+ '-f',
+ 'mp3',
+ outputName
+ ];
+ } else if (outputFormat === 'aac') {
+ args = [
+ '-i',
+ inputName,
+ '-ss',
+ startTime,
+ '-to',
+ endTime,
+ '-c:a',
+ 'aac',
+ '-b:a',
+ '192k',
+ '-f',
+ 'adts',
+ outputName
+ ];
+ } else if (outputFormat === 'wav') {
+ args = [
+ '-i',
+ inputName,
+ '-ss',
+ startTime,
+ '-to',
+ endTime,
+ '-acodec',
+ 'pcm_s16le',
+ '-ar',
+ '44100',
+ '-ac',
+ '2',
+ '-f',
+ 'wav',
+ outputName
+ ];
+ }
+
+ await ffmpeg.exec(args);
+
+ const trimmedAudio = await ffmpeg.readFile(outputName);
+
+ let mimeType = 'audio/mp3';
+ if (outputFormat === 'aac') mimeType = 'audio/aac';
+ if (outputFormat === 'wav') mimeType = 'audio/wav';
+
+ return new File(
+ [
+ new Blob([trimmedAudio], {
+ type: mimeType
+ })
+ ],
+ `${input.name.replace(/\.[^/.]+$/, '')}_trimmed.${outputFormat}`,
+ { type: mimeType }
+ );
+}
diff --git a/src/pages/tools/audio/trim/trim.service.test.ts b/src/pages/tools/audio/trim/trim.service.test.ts
new file mode 100644
index 0000000..5d9faa5
--- /dev/null
+++ b/src/pages/tools/audio/trim/trim.service.test.ts
@@ -0,0 +1,58 @@
+import { expect, describe, it, vi } from 'vitest';
+
+// Mock FFmpeg since it doesn't support Node.js
+vi.mock('@ffmpeg/ffmpeg', () => ({
+ FFmpeg: vi.fn().mockImplementation(() => ({
+ loaded: false,
+ load: vi.fn().mockResolvedValue(undefined),
+ writeFile: vi.fn().mockResolvedValue(undefined),
+ exec: vi.fn().mockResolvedValue(undefined),
+ readFile: vi.fn().mockResolvedValue(new Uint8Array([1, 2, 3, 4, 5])),
+ deleteFile: vi.fn().mockResolvedValue(undefined)
+ }))
+}));
+
+vi.mock('@ffmpeg/util', () => ({
+ fetchFile: vi.fn().mockResolvedValue(new Uint8Array([1, 2, 3, 4, 5]))
+}));
+
+import { trimAudio } from './service';
+
+describe('trimAudio', () => {
+ it('should trim audio file with valid time parameters', async () => {
+ // Create a mock audio file
+ const mockAudioData = new Uint8Array([0, 1, 2, 3, 4, 5]);
+ const mockFile = new File([mockAudioData], 'test.mp3', {
+ type: 'audio/mp3'
+ });
+
+ const options = {
+ startTime: '00:00:10',
+ endTime: '00:00:20',
+ outputFormat: 'mp3' as const
+ };
+
+ const result = await trimAudio(mockFile, options);
+ expect(result).toBeInstanceOf(File);
+ expect(result.name).toContain('_trimmed.mp3');
+ expect(result.type).toBe('audio/mp3');
+ });
+
+ it('should handle different output formats', async () => {
+ const mockAudioData = new Uint8Array([0, 1, 2, 3, 4, 5]);
+ const mockFile = new File([mockAudioData], 'test.wav', {
+ type: 'audio/wav'
+ });
+
+ const options = {
+ startTime: '00:00:00',
+ endTime: '00:00:30',
+ outputFormat: 'wav' as const
+ };
+
+ const result = await trimAudio(mockFile, options);
+ expect(result).toBeInstanceOf(File);
+ expect(result.name).toContain('_trimmed.wav');
+ expect(result.type).toBe('audio/wav');
+ });
+});
diff --git a/src/pages/tools/audio/trim/types.ts b/src/pages/tools/audio/trim/types.ts
new file mode 100644
index 0000000..425f07e
--- /dev/null
+++ b/src/pages/tools/audio/trim/types.ts
@@ -0,0 +1,5 @@
+export type InitialValuesType = {
+ startTime: string;
+ endTime: string;
+ outputFormat: 'mp3' | 'aac' | 'wav';
+};
diff --git a/src/pages/tools/string/censor/index.tsx b/src/pages/tools/string/censor/index.tsx
new file mode 100644
index 0000000..3f6bb60
--- /dev/null
+++ b/src/pages/tools/string/censor/index.tsx
@@ -0,0 +1,158 @@
+import { Box } from '@mui/material';
+import { useState } from 'react';
+import ToolTextResult from '@components/result/ToolTextResult';
+import { GetGroupsType } from '@components/options/ToolOptions';
+import { censorText } from './service';
+import ToolTextInput from '@components/input/ToolTextInput';
+import { InitialValuesType } from './types';
+import ToolContent from '@components/ToolContent';
+import { CardExampleType } from '@components/examples/ToolExamples';
+import { ToolComponentProps } from '@tools/defineTool';
+import TextFieldWithDesc from '@components/options/TextFieldWithDesc';
+import SelectWithDesc from '@components/options/SelectWithDesc';
+import CheckboxWithDesc from '@components/options/CheckboxWithDesc';
+
+const initialValues: InitialValuesType = {
+ wordsToCensor: '',
+ censoredBySymbol: true,
+ censorSymbol: '█',
+ eachLetter: true,
+ censorWord: 'CENSORED'
+};
+
+const exampleCards: CardExampleType[] = [
+ {
+ title: 'Censor a Word in a Quote',
+ description: `In this example, we hide the unpleasant word "idiot" from Jim Rohn's quote. We specify this word in the words-to-censor option and mask it with a neat smiling face character "☺".`,
+ sampleText:
+ 'Motivation alone is not enough. If you have an idiot and you motivate him, now you have a motivated idiot. Jim Rohn',
+ sampleResult:
+ 'Motivation alone is not enough. If you have an ☺ and you motivate him, now you have a motivated ☺. Jim Rohn',
+ sampleOptions: {
+ ...initialValues,
+ wordsToCensor: 'idiot',
+ censorSymbol: '☺',
+ eachLetter: false
+ }
+ },
+ {
+ title: 'Censor an Excerpt',
+ description: `In this example, we censor multiple words from an excerpt from the novel "The Guns of Avalon" by Roger Zelazny. To do this, we write out all unnecessary words in the multi-line text option and select the "Use a Symbol to Censor" censoring mode. We activate the "Mask Each Letter" option so that in place of each word exactly as many block characters "█" appeared as there are letters in that word.`,
+ sampleText:
+ '“In the mirrors of the many judgments, my hands are the color of blood. I sometimes fancy myself an evil which exists to oppose other evils; and on that great Day of which the prophets speak but in which they do not truly believe, on the day the world is utterly cleansed of evil, then I too will go down into darkness, swallowing curses. Until then, I will not wash my hands nor let them hang useless.” ― Roger Zelazny, The Guns of Avalon',
+ sampleResult:
+ '“In the mirrors of the many judgments, my hands are the color of █████. I sometimes fancy myself an ████ which exists to oppose other █████; and on that great Day of which the prophets speak but in which they do not truly believe, on the day the world is utterly cleansed of ████, then I too will go down into ████████, swallowing ██████. Until then, I will not wash my hands nor let them hang useless.” ― Roger Zelazny, The Guns of Avalon',
+ sampleOptions: {
+ ...initialValues,
+ wordsToCensor: 'blood\nevil\ndarkness\ncurses',
+ eachLetter: true
+ }
+ },
+ {
+ title: "Censor Agent's Name",
+ description: `In this example, we hide the name of an undercover FBI agent. We replace two words at once (first name and last name) with the code name "Agent 007"`,
+ sampleText:
+ 'My name is John and I am an undercover FBI agent. I usually write my name in lowercase as "john" because I find uppercase letters scary. Unfortunately, in documents, my name is properly capitalized as John and it makes me upset.',
+ sampleResult:
+ 'My name is Agent 007 and I am an undercover FBI agent. I usually write my name in lowercase as "Agent 007" because I find uppercase letters scary. Unfortunately, in documents, my name is properly capitalized as Agent 007 and it makes me upset.',
+ sampleOptions: {
+ ...initialValues,
+ censoredBySymbol: false,
+ wordsToCensor: 'john',
+ censorWord: 'Agent 007'
+ }
+ }
+];
+
+export default function CensorText({
+ title,
+ longDescription
+}: ToolComponentProps) {
+ const [input, setInput] = useState('');
+ const [result, setResult] = useState('');
+
+ function compute(initialValues: InitialValuesType, input: string) {
+ setResult(censorText(input, initialValues));
+ }
+
+ const getGroups: GetGroupsType = ({
+ values,
+ updateField
+ }) => [
+ {
+ title: 'Words to Censor',
+ component: (
+
+ updateField('wordsToCensor', val)}
+ description={`Specify all unwanted words that
+ you want to hide in text (separated by a new line)`}
+ />
+
+ )
+ },
+ {
+ title: 'Censor Mode',
+ component: (
+
+ updateField('censoredBySymbol', value)}
+ description={'Select the censoring mode.'}
+ />
+
+ {values.censoredBySymbol && (
+ updateField('censorSymbol', val)}
+ description={`A symbol, character, or pattern to use for censoring.`}
+ />
+ )}
+
+ {values.censoredBySymbol && (
+ updateField('eachLetter', value)}
+ title="Mask each letter"
+ description="Put a masking symbol in place of each letter of the censored word."
+ />
+ )}
+
+ {!values.censoredBySymbol && (
+ updateField('censorWord', val)}
+ description={`Replace all censored words with this word.`}
+ />
+ )}
+
+ )
+ }
+ ];
+
+ return (
+
+ }
+ resultComponent={
+
+ }
+ toolInfo={{ title: `What is a ${title}?`, description: longDescription }}
+ exampleCards={exampleCards}
+ />
+ );
+}
diff --git a/src/pages/tools/string/censor/meta.ts b/src/pages/tools/string/censor/meta.ts
new file mode 100644
index 0000000..0a7e6d0
--- /dev/null
+++ b/src/pages/tools/string/censor/meta.ts
@@ -0,0 +1,16 @@
+import { defineTool } from '@tools/defineTool';
+import { lazy } from 'react';
+
+export const tool = defineTool('string', {
+ name: 'Text Censor',
+ path: 'censor',
+ shortDescription:
+ 'Quickly mask bad words or replace them with alternative words.',
+ icon: 'hugeicons:text-footnote',
+ description:
+ "utility for censoring words in text. Load your text in the input form on the left, specify all the bad words in the options, and you'll instantly get censored text in the output area.",
+ longDescription:
+ 'With this online tool, you can censor certain words in any text. You can specify a list of unwanted words (such as swear words or secret words) and the program will replace them with alternative words and create a safe-to-read text. The words can be specified in a multi-line text field in the options by entering one word per line.',
+ keywords: ['text', 'censor', 'words', 'characters'],
+ component: lazy(() => import('./index'))
+});
diff --git a/src/pages/tools/string/censor/service.ts b/src/pages/tools/string/censor/service.ts
new file mode 100644
index 0000000..7aa4b95
--- /dev/null
+++ b/src/pages/tools/string/censor/service.ts
@@ -0,0 +1,49 @@
+import { InitialValuesType } from './types';
+
+export function censorText(input: string, options: InitialValuesType): string {
+ if (!input) return '';
+ if (!options.wordsToCensor) return input;
+
+ if (options.censoredBySymbol && !isSymbol(options.censorSymbol)) {
+ throw new Error('Enter a valid censor symbol (non-alphanumeric or emoji)');
+ }
+
+ const wordsToCensor = options.wordsToCensor
+ .split('\n')
+ .map((word) => word.trim())
+ .filter((word) => word.length > 0);
+
+ let censoredText = input;
+
+ for (const word of wordsToCensor) {
+ const escapedWord = escapeRegex(word);
+ const pattern = new RegExp(`\\b${escapedWord}\\b`, 'giu');
+
+ const replacement = options.censoredBySymbol
+ ? options.eachLetter
+ ? options.censorSymbol.repeat(word.length)
+ : options.censorSymbol
+ : options.censorWord;
+
+ censoredText = censoredText.replace(pattern, replacement);
+ }
+
+ return censoredText;
+}
+
+/**
+ * Escapes RegExp special characters in a string
+ */
+function escapeRegex(str: string): string {
+ return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+/**
+ * Determines if a string is a valid symbol or emoji (multi-codepoint supported).
+ */
+function isSymbol(input: string): boolean {
+ return (
+ /^[^\p{L}\p{N}]+$/u.test(input) || // Not a letter or number
+ /\p{Extended_Pictographic}/u.test(input) // Emoji or pictographic symbol
+ );
+}
diff --git a/src/pages/tools/string/censor/types.ts b/src/pages/tools/string/censor/types.ts
new file mode 100644
index 0000000..aaca65b
--- /dev/null
+++ b/src/pages/tools/string/censor/types.ts
@@ -0,0 +1,7 @@
+export type InitialValuesType = {
+ wordsToCensor: string;
+ censoredBySymbol: boolean;
+ censorSymbol: string;
+ eachLetter: boolean;
+ censorWord: string;
+};
diff --git a/src/pages/tools/string/index.ts b/src/pages/tools/string/index.ts
index e7cecd4..e4979fc 100644
--- a/src/pages/tools/string/index.ts
+++ b/src/pages/tools/string/index.ts
@@ -16,6 +16,7 @@ import { tool as stringRepeat } from './repeat/meta';
import { tool as stringTruncate } from './truncate/meta';
import { tool as stringBase64 } from './base64/meta';
import { tool as stringStatistic } from './statistic/meta';
+import { tool as stringCensor } from './censor/meta';
export const stringTools = [
stringSplit,
@@ -35,5 +36,6 @@ export const stringTools = [
stringRotate,
stringRot13,
stringBase64,
- stringStatistic
+ stringStatistic,
+ stringCensor
];
diff --git a/src/tools/defineTool.tsx b/src/tools/defineTool.tsx
index 7e2e6e5..ecb056c 100644
--- a/src/tools/defineTool.tsx
+++ b/src/tools/defineTool.tsx
@@ -25,6 +25,7 @@ export type ToolCategory =
| 'csv'
| 'pdf'
| 'image-generic'
+ | 'audio'
| 'xml';
export interface DefinedTool {
diff --git a/src/tools/index.ts b/src/tools/index.ts
index 5e4fe33..b0e9bc6 100644
--- a/src/tools/index.ts
+++ b/src/tools/index.ts
@@ -1,9 +1,10 @@
import { stringTools } from '../pages/tools/string';
import { imageTools } from '../pages/tools/image';
import { DefinedTool, ToolCategory } from './defineTool';
-import { capitalizeFirstLetter } from '../utils/string';
+import { capitalizeFirstLetter } from '@utils/string';
import { numberTools } from '../pages/tools/number';
import { videoTools } from '../pages/tools/video';
+import { audioTools } from 'pages/tools/audio';
import { listTools } from '../pages/tools/list';
import { Entries } from 'type-fest';
import { jsonTools } from '../pages/tools/json';
@@ -11,21 +12,23 @@ import { csvTools } from '../pages/tools/csv';
import { timeTools } from '../pages/tools/time';
import { IconifyIcon } from '@iconify/react';
import { pdfTools } from '../pages/tools/pdf';
-import { xmlTools } from 'pages/tools/xml';
+import { xmlTools } from '../pages/tools/xml';
const toolCategoriesOrder: ToolCategory[] = [
'image-generic',
- 'string',
- 'json',
'pdf',
+ 'string',
'video',
+ 'time',
+ 'audio',
+ 'json',
'list',
'csv',
'number',
'png',
'time',
- 'gif',
- 'xml'
+ 'xml',
+ 'gif'
];
export const tools: DefinedTool[] = [
...imageTools,
@@ -37,6 +40,7 @@ export const tools: DefinedTool[] = [
...videoTools,
...numberTools,
...timeTools,
+ ...audioTools,
...xmlTools
];
const categoriesConfig: {
@@ -119,6 +123,12 @@ const categoriesConfig: {
value:
'Tools for working with pictures – compress, resize, crop, convert to JPG, rotate, remove background and much more.'
},
+ {
+ type: 'audio',
+ icon: 'ic:twotone-audiotrack',
+ value:
+ 'Tools for working with audio – extract audio from video, adjusting audio speed, merging multiple audio files and much more.'
+ },
{
type: 'xml',
icon: 'mdi-light:xml',